PSStringFromPropertyKey 関数 (propsys.h)

そのプロパティのキーからプロパティを識別する文字列を作成します。

構文

PSSTDAPI PSStringFromPropertyKey(
  [in]  REFPROPERTYKEY pkey,
  [out] LPWSTR         psz,
  [in]  UINT           cch
);

パラメーター

[in] pkey

型: REFPROPERTYKEY

プロパティを識別する PROPERTYKEY 構造体への参照。

[out] psz

種類: LPWSTR

出力文字列を受け取るバッファーへのポインター。 バッファーは、 PKEYSTR_MAX WCHARを格納するのに十分な大きさにする必要があります。

[in] cch

型: UINT

psz が指すバッファーの長さ (WCHAR単位)。

戻り値

型: HRESULT

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

注釈

取得される文字列形式は です "{propkey.fmtid} propkey.pid"。 たとえば、 の出力文字列 PKEY_Title は です "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2"。

例

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

WCHAR szKey[PKEYSTR_MAX]

HRESULT hr = PSStringFromPropertyKey(PKEY_Title, szKey, ARRAYSIZE(szKey));

if (SUCCEEDED(hr))
{
    // szKey is now valid.
}

要件

こちらもご覧ください

PSGetNameFromPropertyKey

PSPropertyKeyFromString