InitPropVariantFromStringAsVector 関数 (propvarutil.h)

指定した文字列から 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のプロパティバリアントです。 ソース文字列を値のセミコロン リストとして解析します。 文字列 "a;B;c" は、3 つの値を持つベクターを作成します。 先頭と末尾の空白文字は削除され、空の値は省略されます。

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);
}

要件

関連項目

InitPropVariantFromString

InitPropVariantFromStringVector

InitVariantFromStringArray

PropVariantToStringVector