Fungsi PropVariantCopy (combaseapi.h)

Fungsi PropVariantCopy menyalin konten dari satu struktur PROPVARIANT ke struktur lainnya.

Sintaks

HRESULT PropVariantCopy(
  [in, out] PROPVARIANT       *pvarDest,
  [in]      const PROPVARIANT *pvarSrc
);

Parameter

[in, out] pvarDest

Penunjuk ke struktur PROPVARIANT yang tidak diinisialisasi yang menerima salinan.

[in] pvarSrc

Penunjuk ke struktur PROPVARIANT yang akan disalin.

Nilai kembali

Fungsi ini mengembalikan HRESULT.

Keterangan

Menyalin struktur PROPVARIANT berdasarkan nilai sehingga parameter pvarSrc asli dan pvarDest baru dapat dibebaskan secara independen dengan panggilan ke PropVariantClear. PropVariantCopy tidak membebaskan tujuan seperti fungsi VariantCopy . Untuk jenis PROPVARIANT nonsimple seperti VT_STREAM, VT_STORAGE, dan sebagainya, yang memerlukan subobject, salinan dibuat berdasarkan referensi. Pointer disalin, dan IUnknown::AddRef dipanggil di atasnya. Adalah ilegal untuk melewati NULL baik untuk pvarDest atau pvarSrc.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	combaseapi.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

PROPVARIANT, PropVariantClear