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