Metodo IActiveDesktop::GetDesktopItem (shlobj_core.h)

Articolo
03/05/2024

Ottiene l'elemento desktop specificato.

Sintassi

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parametri

nComponent

Tipo: int

Valore intero long senza segno che contiene l'indice dell'elemento desktop. I valori di indice iniziano da zero. Usare IActiveDesktop::GetDesktopItemCount per recuperare un conteggio sul numero totale di elementi 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

I valori di indice cambieranno man mano che gli elementi desktop vengono aggiunti e rimossi da Active Desktop. Le applicazioni non possono presupporre che un valore di indice sia sempre associato a un determinato elemento desktop.

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