IActiveDesktop::GetDesktopItemByID method

Gets the desktop item that matches the given identification.

Syntax


HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parameters

dwID

Type: ULONG_PTR

An unsigned long integer value that contains the desktop item's identification.

pcomp [in, out]

Type: LPCOMPONENT

The address of the COMPONENT structure of the retrieved desktop item.

dwReserved

Type: DWORD

Reserved. Must be set to zero.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlobj.h

DLL

Shell32.dll (version 4.71 or later)

See also

IActiveDesktop

 

 

Show: