Metodo IActiveDesktop::GetDesktopItemByID (shlobj_core.h)

Ottiene l'elemento desktop che corrisponde all'identificazione specificata.

Sintassi

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

Parametri

dwID

Tipo: ULONG_PTR

Valore intero long senza segno che contiene l'identificazione dell'elemento desktop.

[in, out] pcomp

Tipo: LPCOMPONENT

Indirizzo della struttura COMPONENT dell'elemento desktop recuperato.

dwReserved

Tipo: DWORD

Riservato. Deve essere impostato su zero.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'identificazione dell'elemento desktop viene restituita nel membro dwID della struttura COMPONENT restituita dal metodo IActiveDesktop::GetDesktopItem . Questa identificazione è valida solo fino a quando non viene chiamato il metodo IActiveDesktop::ApplyChanges . Le applicazioni che devono recuperare in modo coerente lo stesso elemento desktop devono enumerare gli elementi desktop usando i metodi IActiveDesktop::GetDesktopItem e IActiveDesktop::GetDesktopItemCount .

Requisiti

Vedi anche

IActiveDesktop