IColumnProvider ::GetItemData, méthode (shlobj.h)

Demande des données de colonne pour un fichier spécifié.

Syntaxe

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

Paramètres

[in] pscid

Type : LPCSHCOLUMNID

Structure SHCOLUMNID qui identifie la colonne.

[in] pscd

Type : LPCSHCOLUMNDATA

Structure SHCOLUMNDATA qui spécifie le fichier.

[out] pvarData

Type : VARIANT*

Pointeur vers un VARIANT avec les données du fichier spécifié par pscd qui appartient à la colonne spécifiée par pscid. Définissez cette valeur si le fichier est membre de la classe prise en charge par le fournisseur de colonnes.

Valeur retournée

Type : HRESULT

Retourne S_OK si des données de fichier sont retournées, S_FALSE si le fichier n’est pas pris en charge par le fournisseur de colonnes et qu’aucune donnée n’est retournée, ou une valeur d’erreur COM dans le cas contraire.

Remarques

Cette méthode est appelée pour récupérer les données d’un fichier à afficher dans la colonne spécifiée. Il doit être thread-safe.

Cette méthode est appelée pour chaque fichier que Windows Explorer affiche, même si la plupart d’entre eux ne sont pas pris en charge par un fournisseur de colonnes particulier. Pour améliorer les performances, commencez par case activée le membre pwszExt de la structure pointée par pscd pour voir s’il a une extension de nom de fichier prise en charge par le fournisseur de colonnes. Si ce n’est pas le cas, évitez le traitement inutile en retournant immédiatement S_FALSE.

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