IActiveDesktop::AddUrlIActiveDesktop::AddUrl*
*Contents  *Index  *Topic Contents
*Previous Topic: IActiveDesktop::AddDesktopItemWithUI
*Next Topic: IActiveDesktop::ApplyChanges

IActiveDesktop::AddUrl

HRESULT AddUrl(
    HWND hwnd,
    LPCWSTR pszSource,
    LPCOMPONENT pcomp,
    DWORD dwFlags
);

Adds the desktop item associated with the specified URL.

hwnd
Handle to the parent window for the user interface.
pszSource
String containing the URL of the desktop item.
pcomp
Address of the COMPONENT structure containing the details of the desktop item to be added.
dwFlags
Unsigned long integer value that controls this method. Can be set to ADDURL_SILENT to add a desktop item without displaying any user interfaces.

If the source URL of the desktop item being added matches a desktop item already installed on the Active Desktop, this method will fail.

By default, this method will display some user interface and then add the desktop item to the Active Desktop. Like IActiveDesktop::AddDesktopItem, the client application must call IActiveDesktop::ApplyChanges to have the changes saved to the registry.

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.