IShellDetails::GetDetailsOf メソッド (shlobj_core.h)

シェル フォルダー内のアイテムに関する詳細情報を取得します。

構文

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

パラメーター

[in, optional] pidl

種類: PCUITEMID_CHILD

情報を要求する項目の PIDL。 このパラメーターが NULL に設定されている場合、iColumn で指定された情報フィールドのタイトルは、pDetails が指す SHELLDETAILS 構造体で返されます。

iColumn

型: UINT

目的の情報フィールドの 0 から始まるインデックス。 これは、Windows エクスプローラー詳細ビューに表示される情報の列番号と同じです。

[out] pDetails

型: SHELLDETAILS*

詳細情報を含む SHELLDETAILS 構造体へのポインター。

戻り値

種類: HRESULT

成功した場合は、S_OKを返します。 iColumn がフォルダーでサポートされている列の数を超えた場合は、E_FAILを返します。 それ以外の場合は、標準の COM エラー コードを返します。

注釈

このメソッドは、シェル バージョン 5.0 以降の IShellFolder2 メソッドに置き換わりました。

IShellDetails::GetDetailsOf メソッドは、シェル フォルダーの Windows エクスプローラー Details ビューに表示される情報へのアクセスを提供します。 [詳細] ビューに表示される列番号、列タイトル、およびアイテム情報は、 IShellDetails::GetDetailsOf によって返されるものと同じです。

使用可能な情報フィールドとその列番号は、特定のフォルダーによって異なります。 使用可能なフィールドを列挙するには、iColumn の値を増やすために pidl を NULL に設定して IShellDetails::GetDetailsOf を呼び出します。 この方法では、各列インデックスに関連付けられたタイトルが提供されます。 iColumn がフォルダーでサポートされている列の数を超えると、IShellDetails::GetDetailsOf はE_FAILを返します。 これらのタイトルはローカライズ可能であり、すべてのロケールで同じではない場合があることに注意してください。

ファイル システム フォルダーには、大きな標準の情報フィールドセットがあります。 最初の 4 つのフィールドは、すべてのファイル システム フォルダーの標準です。

ファイル システム フォルダーでは、いくつかの追加フィールドがサポートされている場合があります。 ただし、これらのフィールドは必須ではなく、これらのフィールドに割り当てられた列インデックスが異なる場合があります。

各仮想フォルダーには、固有の情報フィールドのセットがあります。 通常、アイテムの表示名は列 0 ですが、使用可能なフィールドの順序と内容は、特定のフォルダー オブジェクトの実装によって異なります。

実装者への注意

要件