Fungsi PropVariantClear (combaseapi.h)
Fungsi PropVariantClear membebaskan semua elemen yang dapat dikosongkan dalam struktur PROPVARIANT tertentu. Untuk elemen kompleks dengan penunjuk elemen yang diketahui, elemen yang mendasar dikosongkan 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 dikosongkan. Saat kembali, semua nol ditulis ke struktur PROPVARIANT .
Mengembalikan nilai
Fungsi ini mengembalikan HRESULT.
Keterangan
Pada tingkat tidak langsung apa pun, penunjuk 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 ditujukkan oleh anggota pclipdata dari struktur PROPVARIANT dikosongkan.
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 |