SHGetAttributesFromDataObject 関数 (shlobj_core.h)

[SHGetAttributesFromDataObject は、[要件] セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

システム データ オブジェクトから指定された情報を取得します。

構文

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

パラメーター

[in, optional] pdo

型: IDataObject*

情報の取得元となるデータ オブジェクト。

dwAttributeMask

型: DWORD

呼び出し元アプリケーションが取得する情報を示す 1 つ以上の SFGAO フラグ。

[out, optional] pdwAttributes

種類: DWORD*

DWORD 値へのポインター。この関数が正常に返されると、pdo 内のすべてのアイテムに共通する属性のうち、要求された属性を示す 1 つ以上の SFGAO フラグを受け取ります。 この情報が不要な場合、このポインターは NULL にすることができます。

[out, optional] pcItems

種類: UINT*

この関数が正常に返されると、pdo が指すデータ オブジェクト内の PIDL の数を受け取る UINT へのポインター。 この情報が不要な場合、このポインターは NULL にすることができます。

戻り値

種類: HRESULT

この関数は、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	成功しました。
S_FALSE	オブジェクトはシステム データ オブジェクトではありません。 この場合、 pdwAttributes は 0 に設定されます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 6.0 以降)