InitPropVariantFromStringAsVector 函数 (propvarutil.h)
从指定的字符串初始化 PROPVARIANT 结构。 字符串解析为分号分隔列表, (例如:“A;B;C“) 。
语法
PSSTDAPI InitPropVariantFromStringAsVector(
[in] PCWSTR psz,
[out] PROPVARIANT *ppropvar
);
parameters
[in] psz
类型: PCWSTR
指向包含源 Unicode 字符串的缓冲区的指针。
[out] ppropvar
类型: PROPVARIANT*
当此函数返回时,包含初始化的 PROPVARIANT 结构。
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
创建VT_VECTOR |VT_LPWSTR属性变量。 它将源字符串分析为值的分号列表。 字符串“a;B;c“ 创建具有三个值的向量。 删除前导空格和尾随空格,并省略空值。
如果 psz 为 NULL 或不包含任何值, 则 PROPVARIANT 结构初始化为VT_EMPTY。
示例
以下示例将作为更大的程序的一部分包含在内,演示如何使用 InitPropVariantFromStringAsVector。
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStringAsVector(L"a; b; c", &propvar);
if (SUCCEEDED(hr))
{
// propvar now has type VT_VECTOR | VT_LPWSTR and contains {"a", "b", "c"}.
PropVariantClear(&propvar);
}
要求
最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
目标平台 | Windows |
标头 | propvarutil.h |
Library | Propsys.lib |
DLL | Propsys.dll (6.0 或更高版本) |
可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |