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

Obtient l’élément de bureau qui correspond à l’identification donnée.

Syntaxe

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Paramètres

dwID

Type : ULONG_PTR

Valeur entière longue non signée qui contient l’identification de l’élément de bureau.

[in, out] pcomp

Type : LPCOMPONENT

Adresse de la structure COMPONENT de l’élément de bureau récupéré.

dwReserved

Type : DWORD

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

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’identification de l’élément de bureau est retournée dans le membre dwID de la structure COMPONENT qui est retourné à partir de la méthode IActiveDesktop ::GetDesktopItem . Cette identification n’est valide que jusqu’à ce que la méthode IActiveDesktop ::ApplyChanges soit appelée. Les applications qui doivent récupérer le même élément de bureau de manière cohérente doivent énumérer les éléments de bureau à l’aide des méthodes IActiveDesktop ::GetDesktopItem et IActiveDesktop ::GetDesktopItemCount .

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