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 |