PSGetPropertyDescriptionListFromString 関数 (propsys.h)

指定したプロパティ リストのプロパティ説明リスト インターフェイスのインスタンスを取得します。

構文

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

パラメーター

[in] pszPropList

種類: LPCWSTR

プロパティ リストを識別する null で終わる Unicode 文字列へのポインター。 このパラメーターの形式の詳細については、「 IPropertySystem::GetPropertyDescriptionListFromString 」を参照してください。

[in] riid

型: REFIID

要求されたインターフェイスのインターフェイス ID への参照。

[out] ppv

型: void**

この関数が戻るときに、 riid で要求されたインターフェイス ポインターを格納します。 これは通常、 IPropertyDescriptionList です。

戻り値

種類: PSSTDAPI

次のいずれかの値を返します。

リターン コード	説明
S_OK	インターフェイスが取得されました。
E_INVALIDARG	ppv パラメーターは NULL です。

注釈

この関数は 、IPropertySystem::GetPropertyDescriptionListFromString のプロパティ サブシステム実装を呼び出して、セミコロンで区切られたプロパティ リスト文字列として提供されるプロパティのコレクションを取得します。

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

プロパティ スキーマの詳細については、「プロパティ スキーマ」を参照してください。

例

大規模なプログラムの一部として含める次の例では、 PSGetPropertyDescriptionListFromString を使用する方法を示します。

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->Release();
}

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	propsys.h
Library	Propsys.lib
[DLL]	Propsys.dll (バージョン 5.0 以降)
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0