Fungsi FreePropVariantArray (propidl.h)

Mengosongkan memori dan referensi yang digunakan oleh array struktur PROPVARIANT .

Sintaks

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

Parameter

[in] cVariants

Jenis: ULONG

Jumlah elemen dalam array yang ditentukan oleh rgvars.

[in, out] rgvars

Jenis: PROPVARIANT*

Array struktur PROPVARIANT untuk bebas. Ketika fungsi ini berhasil dikembalikan, struktur PROPVARIANT dalam array di-nol dan jenisnya diatur ke VT_EMPTY.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Fungsi ini merilis memori dan referensi yang dipegang oleh setiap struktur dalam array sebelum mengatur struktur ke nol.

Fungsi ini melakukan tindakan yang sama dengan ClearPropVariantArray, tetapi mengembalikan HRESULT.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan FreePropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Persyaratan

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