InitPropVariantFromBoolean 函数 (propvarutil.h)
使用指定的布尔值将给定 PROPVARIANT 结构初始化为 VT_BOOL 。
语法
HRESULT InitPropVariantFromBoolean(
[in] BOOL fVal,
[out] PROPVARIANT *ppropvar
);
参数
[in] fVal
类型： BOOL
源 BOOL 值。
[out] ppropvar
类型： PROPVARIANT*
当此函数返回时，包含初始化的 PROPVARIANT 结构。
返回值
类型： HRESULT
如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
注解
这是一个内联函数，其源代码在 标头中提供。 它不包含在任何 .dll 或 .lib 文件中。
请注意，此函数专门初始化的 boolVal 成员的类型 VARIANT_BOOL，因此 可以具有 VARIANT_TRUE 或 VARIANT_FALSE的值。 直接使用此结构成员时，请使用这些常量而不是 TRUE 或 FALSE ，因为 VARIANT_TRUE 不等于 TRUE ，并且 sizeof (VARIANT_TRUE) 与 sizeof (TRUE) 不同。
示例
以下示例将作为较大程序的一部分包含，演示如何使用 InitPropVariantFromBoolean。
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromBoolean(TRUE, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_BOOL.
PropVariantClear(&propvar);
}
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | propvarutil.h |
| 可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |