Méthode IActiveDesktop ::ModifyDesktopItem (shlobj_core.h)

Modifie l’élément de bureau.

Syntaxe

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

Paramètres

[in, out] pcomp

Type : LPCCOMPONENT

Adresse de la structure COMPONENT qui contient les modifications. L’élément de bureau associé au membre wszSource de la structure sera modifié.

dwFlags

Type : DWORD

Valeur entière longue non signée contenant les indicateurs utilisés pour la modification. Il peut s’agir de l’une des valeurs suivantes.

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

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’application cliente doit appeler IActiveDesktop ::ApplyChanges séparément pour mettre à jour le Registre. Par exemple, pour modifier le nom convivial, appelez d’abord cette fonction avec COMP_ELEM_FRIENDLYNAME ou COMP_ELEM_ALL dans le membre dwFlags de COMPONENT. Appelez ensuite IActiveDesktop ::ApplyChanges.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
DLL	Shlobj_core.h (version 4.71 ou ultérieure)

Voir aussi

IActiveDesktop