Metodo IActiveDesktop::ModifyDesktopItem (shlobj_core.h)

Articolo
03/05/2024

Modifica l'elemento desktop.

Sintassi

HRESULT ModifyDesktopItem(
  [in, out] LPCCOMPONENT pcomp,
            DWORD        dwFlags
);

Parametri

[in, out] pcomp

Tipo: LPCCOMPONENT

Indirizzo della struttura COMPONENT che contiene le modifiche. L'elemento desktop associato al membro wszSource della struttura verrà modificato.

dwFlags

Tipo: DWORD

Valore intero lungo senza segno contenente i flag usati per la modifica. Questo può essere uno dei valori seguenti.

COMP_ELEM_ALL

COMP_ELEM_CHECKED

COMP_ELEM_CURITEMSTATE

COMP_ELEM_FRIENDLYNAME

COMP_ELEM_NOSCROLL

COMP_ELEM_ORIGINAL_CSI

COMP_ELEM_POS_LEFT

COMP_ELEM_POS_TOP

COMP_ELEM_POS_ZINDEX

COMP_ELEM_RESTORED_CSI

COMP_ELEM_SIZE_HEIGHT

COMP_ELEM_SIZE_WIDTH

COMP_ELEM_SOURCE

COMP_ELEM_TYPE

Valore restituito

Tipo: HRESULT

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

Commenti

L'applicazione client deve chiamare IActiveDesktop::ApplyChanges separatamente per aggiornare il Registro di sistema. Ad esempio, per modificare il nome descrittivo, chiamare prima questa funzione con COMP_ELEM_FRIENDLYNAME o COMP_ELEM_ALL nel membro dwFlags di COMPONENT. Chiamare quindi IActiveDesktop::ApplyChanges.

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	Shlobj_core.h (versione 4.71 o successiva)

Vedi anche

IActiveDesktop

Condividi tramite