Méthode IShellDetails ::GetDetailsOf (shlobj_core.h)

Article
03/02/2024

Obtient des informations détaillées sur un élément dans un dossier Shell.

Syntaxe

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

Paramètres

[in, optional] pidl

Type : PCUITEMID_CHILD

PIDL de l’élément pour lequel vous demandez des informations. Si ce paramètre a la valeur NULL, le titre du champ d’informations spécifié par iColumn sera retourné dans la structure SHELLDETAILS pointée vers pDetails.

iColumn

Type : UINT

Index de base zéro du champ d’informations souhaité. Il est identique au numéro de colonne des informations, car elles s’affichent dans une vue Détails de Windows Explorer.

[out] pDetails

Type : SHELLDETAILS*

Pointeur vers une structure SHELLDETAILS avec les informations détaillées.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite. Retourne E_FAIL si iColumn dépasse le nombre de colonnes prises en charge par le dossier. Sinon, retourne un code d’erreur COM standard.

Remarques

Cette méthode a été remplacée par les méthodes IShellFolder2 pour Shell version 5.0 et ultérieure.

La méthode IShellDetails ::GetDetailsOf permet d’accéder aux informations affichées dans la vue Détails de Windows Explorer d’un dossier Shell. Les numéros de colonne, les titres de colonne et les informations d’élément que vous voyez dans la vue Détails sont identiques à ceux retournés par IShellDetails ::GetDetailsOf.

Les champs d’informations disponibles et leurs numéros de colonne varient en fonction du dossier particulier. Pour énumérer les champs disponibles, appelez IShellDetails ::GetDetailsOf avec pidl défini sur NULL pour augmenter les valeurs d’iColumn. Cette approche vous fournit le titre associé à chaque index de colonne. Lorsque iColumn dépasse le nombre de colonnes prises en charge par le dossier, IShellDetails ::GetDetailsOf retourne E_FAIL. Gardez à l’esprit que ces titres sont localisables et peuvent ne pas être identiques pour tous les paramètres régionaux.

Les dossiers de système de fichiers ont un grand ensemble standard de champs d’informations. Les quatre premiers champs sont standard pour tous les dossiers de système de fichiers.

Index de colonne	Titre de la colonne
0	Nom
1	Taille
2	Type
3	Date de modification

Les dossiers de système de fichiers peuvent prendre en charge un certain nombre de champs supplémentaires. Toutefois, ils ne sont pas obligés de le faire et les index de colonne affectés à ces champs peuvent varier.

Chaque dossier virtuel a son propre ensemble unique de champs d’informations. En règle générale, le nom d’affichage de l’élément se trouve dans la colonne zéro, mais l’ordre et le contenu des champs disponibles dépendent de l’implémentation de l’objet dossier particulier.

Remarque à l’attention des implémenteurs

Les objets folder doivent implémenter IShellFolder2 au lieu de cette interface.

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

Partager via