Fungsi ClearPropVariantArray (propvarutil.h)

Membebaskan memori dan referensi yang digunakan oleh array struktur PROPVARIANT yang disimpan dalam array.

Sintaks

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

Parameter

[in] rgPropVar

Jenis: PROPVARIANT*

Array struktur PROPVARIANT untuk membebaskan.

[in] cVars

Jenis: UINT

Jumlah elemen dalam array yang ditentukan oleh rgPropVar.

Nilai kembali

Tidak ada nilai yang ditampilkan.

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 FreePropVariantArray, tetapi FreePropVariantArray mengembalikan HRESULT.

Contoh

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

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

Persyaratan

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

Lihat juga

ClearVariantArray