IActiveDesktop::AddDesktopItemWithUIIActiveDesktop::AddDesktopItemWithUI*
*Contents  *Index  *Topic Contents
*Previous Topic: IActiveDesktop::AddDesktopItem
*Next Topic: IActiveDesktop::AddUrl

IActiveDesktop::AddDesktopItemWithUI

HRESULT AddDesktopItemWithUI(
    HWND hwnd,
    LPCOMPONENT pcomp,
    DWORD dwReserved
);

Adds a desktop item to the Active Desktop after displaying user interfaces that confirm the addition of the desktop item, verify security zone permissions, and ask if the user wants to create a subscription.

hwnd
Handle of the parent window. If NULL, the desktop item will be added without displaying any user interface.
pcomp
Address of the COMPONENT structure containing the details of the desktop item to be added.
dwReserved
Reserved. Must be set to zero.

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

This method creates a second instance of the Active Desktop to add the desktop item, so the desktop item will not appear in the current instance. The application must call the IUnknown::Release method on this IActiveDesktop interface and the use the CoCreateInstance function to get the Active Desktop object with the newly added component.

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