initVariantFromString 函式 (propvarutil.h)

發行項
03/01/2024

使用字串初始化 VARIANT 結構。

語法

HRESULT InitVariantFromString(
  [in]  PCWSTR  psz,
  [out] VARIANT *pvar
);

參數

[in] psz

類型： PCWSTR

包含來源 Unicode 字串的緩衝區指標。如果此值為 NULL，函式會使用 NULLBSTR 初始化 VARIANT。

[out] pvar

類型： VARIANT*

當此函式傳回時，會包含初始化的 VARIANT 結構。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

建立VT_BSTR變體。

這是內嵌函式，其原始程式碼會在標頭中提供。它不包含在任何 .dll 或 .lib 檔案中。

範例

下列範例會示範如何使用 InitVariantFromString 作為較大程式的一部分。

VARIANT var;

HRESULT hr = InitVariantFromString(L"This is a test", &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_BSTR.
    VariantClear(&var);
}

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台	Windows
標頭	propvarutil.h
Dll	Propsys.dll (6.0 版或更新版本)
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0