Skip to content

Latest commit

 

History

History
137 lines (106 loc) · 3.95 KB

nf-shlobj_core-iactivedesktop-addurl.md

File metadata and controls

137 lines (106 loc) · 3.95 KB
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.
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
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
IActiveDesktop::AddUrl
shlobj_core/IActiveDesktop::AddUrl
c++
APIRef
kbSyntax
COM
Shell32.dll
IActiveDesktop.AddUrl

IActiveDesktop::AddUrl

-description

Adds the desktop item associated with the specified URL.

-parameters

-param hwnd [in, optional]

Type: HWND

A handle to the parent window for the user interface.

-param pszSource [in]

Type: PCWSTR

A pointer to a string that contains the URL of the desktop item.

-param pcomp [in]

Type: LPCOMPONENT

A pointer to the COMPONENT structure that contains the details of the desktop item to be added.

-param dwFlags

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.

-returns

Type: HRESULT

Returns one of the following values.

Return code Description
E_FAIL
Failed to add the desktop item or an instance of the desktop item already exists on the Active Desktop.
E_INVAILDARG
One or more of the parameters were invalid.
S_OK
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.

-remarks

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.

-see-also

IActiveDesktop

Using the Active Desktop Object