IShellFolder2 ::GetDetailsOf, méthode (shobjidl_core.h)

Article
03/02/2024

Obtient des informations détaillées, identifiées par un index de colonne, sur un élément dans un dossier Shell.

Syntaxe

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

Paramètres

[in] pidl

Type : PCUITEMID_CHILD

PIDL de l’élément pour lequel vous demandez des informations. Cette méthode n’accepte que les codes PIDL à un seul niveau. La structure doit contenir exactement une structure SHITEMID suivie d’un zéro de fin. Si ce paramètre a la valeur NULL, le titre du champ d’informations spécifié par iColumn est retourné.

[in] 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 Windows Explorer Détails.

[out] psd

Type : SHELLDETAILS*

Pointeur vers une structure SHELLDETAILS qui contient les informations.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La méthode IShellFolder2 ::GetDetailsOf est identique à GetDetailsOf. Pour obtenir un moyen plus robuste de récupérer des informations d’élément qui ne nécessitent pas de connaître l’index de colonne, utilisez IShellFolder2 ::GetDetailsEx.

La méthode IShellFolder2 ::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 en-têtes et les informations que vous voyez dans la vue Détails sont identiques à ceux de IShellFolder2 ::GetDetailsOf. Notez que les champs d’informations disponibles et leurs numéros de colonne varient en fonction du dossier particulier. Vous pouvez énumérer les champs disponibles en appelant cette méthode avec pidl défini sur NULL et en examinant le titre associé à chaque index de colonne. Gardez à l’esprit que ces titres peuvent être localisés et peuvent ne pas être identiques pour tous les paramètres régionaux.

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

Index de colonne	Titre de 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. Normalement, le nom d’affichage de l’élément se trouve dans la colonne zéro, mais l’ordre et le contenu des champs restants dépendent de l’implémentation de l’objet dossier 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 Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via