Partager via

Fonction SHGetAttributesFromDataObject (shlobj_core.h)

  • Article

[SHGetAttributesFromDataObject est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Récupère des éléments d’informations spécifiés à partir d’un objet de données système.

Syntaxe

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Paramètres

[in, optional] pdo

Type : IDataObject*

Objet de données à partir duquel récupérer les informations.

dwAttributeMask

Type : DWORD

Un ou plusieurs des indicateurs SFGAO qui indiquent les informations que l’application appelante souhaite récupérer.

[out, optional] pdwAttributes

Type : DWORD*

Pointeur vers une valeur DWORD qui, lorsque cette fonction retourne correctement, reçoit un ou plusieurs indicateurs SFGAO qui indiquent les attributs, parmi ceux demandés, qui sont communs à tous les éléments dans pdo. Ce pointeur peut avoir la valeur NULL si ces informations ne sont pas nécessaires.

[out, optional] pcItems

Type : UINT*

Pointeur vers un UINT qui, lorsque cette fonction retourne correctement, reçoit le nombre de PIDL dans l’objet de données pointé vers pdo. Ce pointeur peut avoir la valeur NULL si ces informations ne sont pas nécessaires.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
 Opération réussie.
S_FALSE
 L’objet n’est pas un objet de données système. Dans ce cas, pdwAttributes est défini sur 0.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h (inclure Shlobj.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 6.0 ou ultérieure)