InitPropVariantFromResource 函数 (propvarutil.h)
基于可执行文件中嵌入的字符串资源初始化 PROPVARIANT 结构。
语法
PSSTDAPI InitPropVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] PROPVARIANT *ppropvar
);
parameters
[in] hinst
类型: HINSTANCE
其可执行文件包含字符串资源的模块实例的句柄。
[in] id
类型: UINT
要加载的字符串的整数标识符。
[out] ppropvar
类型: PROPVARIANT*
当此函数返回时,包含初始化的 PROPVARIANT 结构。
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
此函数创建一个VT_LPWSTR支持变量。 如果指定的资源不存在,它将使用空字符串初始化 PROPVARIANT 。 长度超过 1024 个字符的资源字符串将被截断并用 null 结尾。
示例
以下示例将作为较大程序的一部分包含,演示如何使用 InitPropVariantFromResource。
// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromResource(hinst, id, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
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 |