Bagikan melalui

Fungsi PropVariantToVariant (propvarutil.h)

  • Artikel

Mengonversi konten struktur PROPVARIANT menjadi struktur VARIAN .

Sintaks

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

Parameter

[in] pPropVar

Jenis: const PROPVARIANT*

Penunjuk ke struktur PROPVARIANT sumber.

[out] pVar

Jenis: VARIAN*

Penunjuk ke struktur VARIAN . Ketika fungsi ini kembali, VARIAN berisi informasi yang dikonversi.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Biasanya, data yang disimpan di PROPVARIANT disalin ke VARIAN tanpa perubahan jenis data. Namun, dalam kasus berikut, tidak ada dukungan VARIAN langsung untuk jenis data, dan dikonversi seperti yang ditunjukkan.

Jenis PROPVARIANT Asli Disimpan sebagai Jenis VARIAN
VT_BLOB, VT_STREAM VT_UNKNOWN. Anggota punkVal akan berisi penunjuk ke IStream yang berisi data sumber.
VT_LPSTR, VT_LPWSTR, VT_CLSID VT_BSTR
VT_FILETIME VT_DATE
VT_VECTOR|x VT_ARRAY|y
 

Tipe berikut tidak dapat dikonversi dengan fungsi ini.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform Windows
Header propvarutil.h
Pustaka Propsys.lib
DLL Propsys.dll (versi 6.0 atau yang lebih baru)
Redistribusi Windows Desktop Search (WDS) 3.0