Fungsi VariantCopyInd (oleauto.h)

Artikel
03/01/2024

Membebaskan varian tujuan dan membuat salinan varian sumber, melakukan tidak langsung yang diperlukan jika sumber ditentukan untuk VT_BYREF.

Sintaks

HRESULT VariantCopyInd(
  [out] VARIANT          *pvarDest,
  [in]  const VARIANTARG *pvargSrc
);

Parameter

[out] pvarDest

Varian tujuan.

[in] pvargSrc

Varian sumber.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
DISP_E_ARRAYISLOCKED	Varian berisi array yang dikunci.
DISP_E_BADVARTYPE	Jenis varian bukan tipe varian yang valid.
E_INVALIDARG	Salah satu argumen tidak valid.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.

Keterangan

Fungsi ini berguna ketika salinan varian diperlukan, dan untuk menjamin bahwa itu tidak VT_BYREF, seperti saat menangani argumen dalam implementasi IDispatch::Invoke.

Misalnya, jika sumbernya adalah (VT_BYREF | VT_I2), tujuannya adalah BYVAL | VT_I2. Hal yang sama berlaku untuk semua kombinasi VT_BYREF hukum, termasuk VT_VARIANT.

Jika pvargSrc adalah (VT_BYREF | VT_VARIANT), dan varian yang terkandung VT_BYREF, varian yang terkandung juga didereferensikan.

Fungsi ini membebaskan konten pvarDest yang ada.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	oleauto.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Lihat juga

Fungsi Manipulasi Varian

Bagikan melalui