通过

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