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

Article
03/02/2024

Ajoute un élément de bureau.

Syntaxe

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

Paramètres

[in] pcomp

Type : LPCCOMPONENT

Pointeur vers la structure COMPONENT qui spécifie l’élément à ajouter.

dwReserved

Type : DWORD

Réservé. Doit être défini sur zéro.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
E_FAIL	Échec de l’ajout de l’élément de bureau, ou une instance de l’élément de bureau existe déjà sur Active Desktop.
E_INVAILDARG	Un ou plusieurs des paramètres n’étaient pas valides.
S_OK	L’élément de bureau a été ajouté avec succès.

Remarques

L’élément de bureau est ajouté au bureau, mais il ne l’enregistre pas dans le Registre. L’application cliente doit appeler IActiveDesktop ::ApplyChanges séparément pour mettre à jour le Registre.

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	Shell32.dll (version 4.71 ou ultérieure)

Voir aussi

IActiveDesktop

Utilisation de l’objet Active Desktop

Partager via