IShellFolder::GetAttributesOf メソッド (shobjidl_core.h)

  • [アーティクル]

IShellFolder で表される オブジェクトに含まれる 1 つ以上のファイル オブジェクトまたはフォルダー オブジェクトの属性を取得します。

構文

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

パラメーター

[in] cidl

型: UINT

属性の取得元となる項目の数。

[in] apidl

種類: PCUITEMID_CHILD_ARRAY*

ITEMIDLIST 構造体へのポインターの配列のアドレス。各構造体は、親フォルダーを基準にして項目を一意に識別します。 各 ITEMIDLIST 構造体には、1 つの SHITEMID 構造体の後に終端の 0 が続く必要があります。

[in, out] rgfInOut

種類: SFGAOF*

入力時に、呼び出し元アプリケーションが要求しているビットごとの SFGAO 属性を含む単一の ULONG 値へのポインター。 終了時に、この値には、指定されたすべての項目に共通する要求された属性が含まれます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

この操作を最適化するために、指定されていないフラグを返さないでください。

フォルダー オブジェクトの場合、 SFGAO_BROWSABLE 属性は、クライアントがこのオブジェクトにバインドできることを意味します。これは、ここで一般的な形式で示されています。

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

その後、クライアントは、このステートメントを使用してそのアイテムに IShellView を作成できます。

psfItem->CreateViewObject(..., IID_IShellView,...);

SFGAO_DROPTARGET属性は、次に示すように IShellFolder::GetUIObjectOf を呼び出すことによって、クライアントがこのフォルダーの IDropTarget のインスタンスにバインドできることを意味します。

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

SFGAO_NONENUMERATED属性は、 IShellFolder::EnumObjects メソッドによって作成された列挙子によって返されないアイテムを示します。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
[DLL] Shell32.dll (バージョン 4.0 以降)

関連項目

IShellFolder

IShellFolder2