UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:shlobj_core.IActiveDesktop.AddUrl |
IActiveDesktop::AddUrl (shlobj_core.h) |
Adds the desktop item associated with the specified URL. |
|
lwef\iactivedesktop_addurl_method.htm |
lwef |
295b2f46-6178-4aef-9721-8105c75a4a55 |
12/05/2018 |
AddUrl, AddUrl method [Legacy Windows Environment Features], AddUrl method [Legacy Windows Environment Features],IActiveDesktop interface, IActiveDesktop interface [Legacy Windows Environment Features],AddUrl method, IActiveDesktop.AddUrl, IActiveDesktop::AddUrl, _win32_IActiveDesktop_AddUrl_Method, lwef.iactivedesktop_addurl_method, shell.iactivedesktop_addurl_method, shlobj_core/IActiveDesktop::AddUrl |
shlobj_core.h |
Windows |
Windows 2000 Professional, Windows XP [desktop apps only] |
Windows 2000 Server [desktop apps only] |
Shell32.dll (version 4.71 or later) |
Windows |
19H1 |
|
|
|
|
|
|
Adds the desktop item associated with the specified URL.
Type: HWND
A handle to the parent window for the user interface.
Type: PCWSTR
A pointer to a string that contains the URL of the desktop item.
Type: LPCOMPONENT
A pointer to the COMPONENT structure that contains the details of the desktop item to be added.
Type: DWORD
An unsigned long integer value that controls this method. Can be set to ADDURL_SILENT to add a desktop item without displaying any user interfaces.
Type: HRESULT
Returns one of the following values.
Return code | Description |
---|---|
|
Failed to add the desktop item or an instance of the desktop item already exists on the Active Desktop. |
|
One or more of the parameters were invalid. |
|
If the ADDURL_SILENT flag has been set, the desktop item has either been added successfully or it already exists on the Active Desktop. Otherwise, the desktop item has been added successfully. |
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.