PSPropertyKeyFromString 関数 (propsys.h)

  • [アーティクル]

文字列を PROPERTYKEY 構造体に変換します。

構文

PSSTDAPI PSPropertyKeyFromString(
  [in]  LPCWSTR     pszString,
  [out] PROPERTYKEY *pkey
);

パラメーター

[in] pszString

種類: LPCWSTR

変換する null で終わる Unicode 文字列へのポインター。

[out] pkey

型: PROPERTYKEY*

この関数が戻るとき、 には PROPERTYKEY 構造体へのポインターが含まれます。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

変換する文字列は、 として "{fmtid} pid"書式設定する必要があります。 たとえば、 に対応 PKEY_Title する文字列は です "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2"。 PSStringFromPropertyKey は、この形式で文字列を出力します。

プロパティ スキーマにプロパティが存在しない場合でも、この関数は有効なプロパティ キー文字列に対して成功します。

例

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

PROPERTYKEY key;

HRESULT hr = PSPropertyKeyFromString(L"{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2", &key);

if (SUCCEEDED(hr))
{
    // The key variable is now valid.
}

要件

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

こちらもご覧ください

PSGetPropertyKeyFromName

PSStringFromPropertyKey