PropVariantToVariant 関数 (propvarutil.h)

PROPVARIANT 構造体の内容を VARIANT 構造体に変換します。

構文

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

パラメーター

[in] pPropVar

型: const PROPVARIANT*

ソース PROPVARIANT 構造体へのポインター。

[out] pVar

型: VARIANT*

VARIANT 構造体へのポインター。 この関数が戻ると、 VARIANT には変換された情報が含まれます。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

通常、 PROPVARIANT に格納されているデータは、データ型を変更せずに VARIANT にコピーされます。 ただし、次の場合、データ型に対する直接 の VARIANT サポートはなく、次のように変換されます。

の PROPVARIANT VARIANT 型として格納される
VT_BLOB、VT_STREAM VT_UNKNOWN。 punkVal メンバーには、ソース データを含む IStream へのポインターが含まれます。
VT_LPSTR、VT_LPWSTR、VT_CLSID VT_BSTR
VT_FILETIME VT_DATE
VT_VECTOR|x VT_ARRAY|y
 

この関数では、次の型を変換できません。

  • VT_STORAGE
  • VT_BLOB_OBJECT
  • VT_STREAMED_OBJECT
  • VT_STORED_OBJECT
  • VT_CF
  • VT_VECTOR |VT_CF

要件

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