InitPropVariantFromStringAsVector 函式 (propvarutil.h)

發行項
08/25/2023

從指定的字串初始化 PROPVARIANT 結構。字串會剖析為分號分隔清單 (例如：「A;B;C「) 。

語法

PSSTDAPI InitPropVariantFromStringAsVector(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

參數

[in] psz

類型： PCWSTR

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

[out] ppropvar

類型： PROPVARIANT*

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

傳回值

類型： HRESULT

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

備註

建立VT_VECTOR |VT_LPWSTR propvariant。它會將來源字串剖析為值的分號清單。字串「a;B;c「會建立具有三個值的向量。會移除開頭和尾端空白字元，並省略空白值。

如果 psz 為 Null 或不包含任何值，則 PROPVARIANT 結構會初始化為VT_EMPTY。

範例

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

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStringAsVector(L"a; b; c", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now has type VT_VECTOR | VT_LPWSTR and contains {"a", "b", "c"}.
    PropVariantClear(&propvar);
}

需求


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