Metodo IActiveDesktop::AddDesktopItem (shlobj_core.h)

Aggiunge un elemento desktop.

Sintassi

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

Parametri

[in] pcomp

Tipo: LPCCOMPONENT

Puntatore alla struttura COMPONENT che specifica l'elemento da aggiungere.

dwReserved

Tipo: DWORD

Riservato. Deve essere impostato su zero.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_FAIL	Impossibile aggiungere l'elemento desktop o un'istanza dell'elemento desktop esiste già in Active Desktop.
E_INVAILDARG	Uno o più parametri non sono validi.
S_OK	L'elemento desktop è stato aggiunto correttamente.

Commenti

L'elemento desktop viene aggiunto al desktop, ma non lo salva nel Registro di sistema. L'applicazione client deve chiamare separatamente IActiveDesktop::ApplyChanges per aggiornare il Registro di sistema.

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

Utilizzo dell'oggetto Desktop attivo