IPropertyStoreFactory::GetPropertyStore メソッド (propsys.h)
指定されたフラグに対応する IPropertyStore オブジェクトを取得します。
構文
HRESULT GetPropertyStore(
[in] GETPROPERTYSTOREFLAGS flags,
[in] IUnknown *pUnkFactory,
[in] REFIID riid,
[out] void **ppv
);
パラメーター
[in] flags
返されるストアを変更する 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 |