IColumnProvider::GetItemData メソッド (shlobj.h)

指定したファイルの列データを要求します。

構文

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

パラメーター

[in] pscid

種類: LPCSHCOLUMNID

列を識別する SHCOLUMNID 構造体。

[in] pscd

型: LPCSHCOLUMNDATA

ファイルを指定する SHCOLUMNDATA 構造体。

[out] pvarData

型: VARIANT*

pscid で指定された列に属する pscd で指定されたファイルのデータを含む VARIANT へのポインター。 ファイルが列プロバイダーでサポートされているクラスのメンバーである場合は、この値を設定します。

戻り値

種類: HRESULT

ファイル データが返された場合はS_OKを返し、ファイルが列プロバイダーでサポートされておらず、データが返されない場合は S_FALSE、それ以外の場合は COM エラー値を返します。

注釈

このメソッドは、指定された列に表示されるファイルのデータを取得するために呼び出されます。 スレッド セーフである必要があります。

このメソッドは、Windows エクスプローラー表示されるすべてのファイルに対して呼び出されます。ただし、その多くは特定の列プロバイダーでサポートされません。 パフォーマンスを向上させるには、まず pscd が指す構造体の pwszExt メンバーをチェックして、列プロバイダーでサポートされているファイル名拡張子があるかどうかを確認します。 そうでない場合は、すぐにS_FALSEを返すことによって、不要な処理を避けてください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj.h
[DLL]	Shell32.dll (バージョン 5.0 以降)