Metodo IActiveDesktop::GetDesktopItemByID (shlobj_core.h)

Articolo
03/02/2024

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h
DLL	Shell32.dll (versione 4.71 o successiva)

Vedi anche

IActiveDesktop

Condividi tramite