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);
}
要件
| サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | propvarutil.h |
| Library | Propsys.lib |
| [DLL] | Propsys.dll (バージョン 6.0 以降) |
| 再頒布可能パッケージ | Windows デスクトップ検索 (WDS) 3.0 |