IActiveDesktop::GetDesktopItemByIDIActiveDesktop::GetDesktopItemByID*
*Contents  *Index  *Topic Contents
*Previous Topic: IActiveDesktop::GetDesktopItem
*Next Topic: IActiveDesktop::GetDesktopItemBySource

IActiveDesktop::GetDesktopItemByID

HRESULT GetComponentByID(
    DWORD dwID,
    LPCOMPONENT pcomp,
    DWORD dwReserved
);

Retrieves the desktop item that matches the given identification.

dwID
Unsigned long integer value that contains the desktop item's identification.
pcomp
Address of the COMPONENT structure of the retrieved desktop item.
dwReserved
Reserved. Must be set to zero.

The desktop item's identification is returned in the dwID member of the COMPONENT structure returned from the IActiveDesktop::GetDesktopItem method. This identification is only valid until the IActiveDesktop::ApplyChanges method is called. Applications that need to get the same desktop item consistently should enumerate the desktop items using the IActiveDesktop::GetDesktopItem and IActiveDesktop::GetDesktopItemCount methods.

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