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

指定されたフラグに対応する IPropertyStore オブジェクトを取得します。

構文

HRESULT GetPropertyStore(
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  IUnknown              *pUnkFactory,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

パラメーター

[in] flags

型: GETPROPERTYSTOREFLAGS

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

[in] pUnkFactory

種類: IUnknown*

省略可能。 ICreateObject を実装するオブジェクトの IUnknown へのポインター。 pUnkFactory が指定されている場合、このメソッドは、実装されている場合は CoCreateInstance ではなく ICreateObject を使用してハンドラー インスタンスを作成できます。 pUnkFactory を提供する理由は、通常、別のプロセスでハンドラーを作成するためです。 ただし、ほとんどのユーザーにとって、このパラメーターで NULL を 渡すことで十分です。

[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