IActiveDesktop::AddDesktopItem method (shlobj_core.h)
Adds a desktop item.
HRESULT AddDesktopItem( [in] LPCCOMPONENT pcomp, DWORD dwReserved );
A pointer to the COMPONENT structure that specifies the item to be added.
Reserved. Must be set to zero.
Returns one of the following values.
||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.|
||Desktop item has been added successfully.|
The desktop item is added to the desktop, but it does not save it to the registry. The client application must call IActiveDesktop::ApplyChanges separately to update the registry.
|Minimum supported client||Windows 2000 Professional, Windows XP [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|DLL||Shell32.dll (version 4.71 or later)|