共用方式為

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
程式庫 Propsys.lib
Dll Propsys.dll (6.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0