Fungsi FreePropVariantArray (combaseapi.h)

Fungsi FreePropVariantArray memanggil PropVariantClear pada setiap struktur PROPVARIANT dalam array rgvars untuk membuat nilai nol untuk setiap anggota array.

Sintaks

HRESULT FreePropVariantArray(
  [in] ULONG       cVariants,
  [in] PROPVARIANT *rgvars
);

Parameter

[in] cVariants

Jumlah elemen dalam array PROPVARIANT (rgvars).

[in] rgvars

Penunjuk ke array yang diinisialisasi dari struktur PROPVARIANT yang elemennya dapat dibatalkan akan dibebaskan. Saat keluar, semua nol ditulis ke struktur PROPVARIANT (sehingga menandainya sebagai VT_EMPTY).

Nilai kembali

Fungsi ini mengembalikan HRESULT.

Keterangan

FreePropVariantArray memanggil PropVariantClear pada array struktur PROPVARIANT untuk menghapus semua anggota yang valid. Semua struktur PROPVARIANT yang valid dibebaskan. Jika salah satu struktur PROPVARIANT berisi jenis VT ilegal, anggota yang valid akan dibebaskan dan fungsi mengembalikan STG_E_INVALIDPARAMETER.

Melewati NULL untuk rgvars adalah legal, dan menghasilkan kode pengembalian S_OK.

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

PropVariantClear