Fungsi PropVariantClear (combaseapi.h)
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.
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 |