IActiveDesktop ::GetDesktopItem, méthode (shlobj_core.h)

Obtient l’élément de bureau spécifié.

Syntaxe

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Paramètres

nComponent

Type : int

Valeur entière longue non signée qui contient l’index de l’élément de bureau. Les valeurs d’index commencent à zéro. Utilisez IActiveDesktop ::GetDesktopItemCount pour récupérer un décompte sur le nombre total d’éléments 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

Les valeurs d’index changent à mesure que des éléments de bureau sont ajoutés et supprimés d’Active Desktop. Les applications ne peuvent pas supposer qu’une valeur d’index sera toujours associée à un élément de bureau particulier.

Configuration requise

Voir aussi

IActiveDesktop