Fungsi PropVariantClear (combaseapi.h)

  • Artikel

Fungsi PropVariantClear membebaskan semua elemen yang dapat dibebaskan dalam struktur PROPVARIANT tertentu. Untuk elemen kompleks dengan penunjuk elemen yang diketahui, elemen yang mendasar dibebaskan sebelum membebaskan elemen yang berisi.

Sintaks

HRESULT PropVariantClear(
  [in] PROPVARIANT *pvar
);

Parameter

[in] pvar

Penunjuk ke struktur PROPVARIANT yang diinisialisasi yang elemennya dapat dibatalkan akan dibebaskan. Saat dikembalikan, semua nol ditulis ke struktur PROPVARIANT .

Mengembalikan nilai

Fungsi ini mengembalikan HRESULT.

Keterangan

Pada tingkat tidak langsung apa pun, pointer NULL diabaikan. Misalnya, parameter pvar menunjuk ke struktur proPVARIANT jenis VT_CF. Anggota pclipdata dari struktur PROPVARIANT menunjuk ke struktur CLIPDATA . Penunjuk pClipData dalam struktur CLIPDATA adalah NULL. Dalam contoh ini, penunjuk pClipData diabaikan. Namun, struktur CLIPDATA yang ditunjukkan oleh anggota pclipdata dari struktur PROPVARIANT dibebaskan.

Saat dikembalikan, fungsi ini menulis nol ke struktur PROPVARIANT yang ditentukan, sehingga jenis VT VT_EMPTY.

Meneruskan NULL sebagai parameter pvar menghasilkan kode pengembalian S_OK.

Catatan Jangan gunakan fungsi ini untuk menginisialisasi struktur PROPVARIANT . Sebagai gantinya, inisialisasi struktur ini menggunakan makro PropVariantInit (didefinisikan dalam Propidl.h).
 

Persyaratan

   
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

FreePropVariantArray