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

请参阅

InitPropVariantFromString

InitVariantFromResource

LoadString

PropVariantToString

PropVariantToStringWithDefault