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

Article
03/13/2024

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

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

Partager via