IPropertyStoreFactory::GetPropertyStoreForKeys メソッド (propsys.h)

プロパティ キーのセットを指定して、 IPropertyStore オブジェクトを取得します。 これにより、 IPropertyStoreFactory::GetPropertyStore の呼び出しと比較して 、IPropertyStore オブジェクトを取得する別の方法 (場合によっては高速) が提供されます。

構文

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

パラメーター

[in] rgKeys

型: const PROPERTYKEY*

PROPERTYKEY 構造体の配列へのポインター。

[in] cKeys

型: UINT

rgKeys が指す配列内の PROPERTYKEY 構造体の数。

[in] flags

型: GETPROPERTYSTOREFLAGS

返されるストアを変更する GETPROPERTYSTOREFLAGS 値。

[in] riid

型: REFIID

作成するオブジェクトの IID への参照。

[out] ppv

型: void**

このメソッドから制御が戻るときに、 IPropertyStore インターフェイス ポインターのアドレスが格納されます。

戻り値

型: HRESULT

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

注釈

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供するため、コーディング エラーが発生する可能性がなくなります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	propsys.h