initPropVariantFromString 函式 (propvarutil.h)

發行項
03/01/2024

根據指定的字串，初始化 PROPVARIANT 結構。

語法

HRESULT InitPropVariantFromString(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

參數

[in] psz

類型： PCWSTR

包含來源 Unicode 字串之緩衝區的指標。

[out] ppropvar

類型： PROPVARIANT*

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

傳回值

類型： HRESULT

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

備註

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

範例

下列範例要包含在較大的程式中，示範如何使用 InitPropVariantFromString。

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &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
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0