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 |