Fungsi CoUninitialize (combaseapi.h)
Menutup pustaka COM pada utas saat ini, membongkar semua DLL yang dimuat oleh utas, membebaskan sumber daya lain yang dipertahankan utas, dan memaksa semua koneksi RPC pada utas ditutup.
Sintaks
void CoUninitialize();
Mengembalikan nilai
Tidak ada
Keterangan
Utas harus memanggil CoUninitialize sekali untuk setiap panggilan yang berhasil dilakukan ke fungsi CoInitialize atau CoInitializeEx , termasuk panggilan apa pun yang mengembalikan S_FALSE. Hanya panggilan CoUninitialize yang sesuai dengan panggilan CoInitialize atau CoInitializeEx yang menginisialisasi pustaka yang dapat menutupnya.
Panggilan ke OleInitialize harus diseimbangkan dengan panggilan ke OleUninitialize. Fungsi OleUninitialize memanggil CoUninitialize secara internal, sehingga aplikasi yang memanggil OleUninitialize tidak juga perlu memanggil CoUninitialize.
CoUninitialize harus dipanggil pada pematian aplikasi, karena panggilan terakhir yang dilakukan ke pustaka COM setelah aplikasi menyembunyikan jendela utamanya dan jatuh melalui perulangan pesan utamanya. Jika ada percakapan terbuka yang tersisa, CoUninitialize memulai perulangan pesan modal dan mengirimkan pesan yang tertunda dari kontainer atau server untuk aplikasi COM ini. Dengan mengirimkan pesan, CoUninitialize memastikan bahwa aplikasi tidak berhenti sebelum menerima semua pesan yang tertunda. Pesan non-COM dibuang.
Karena tidak ada cara untuk mengontrol urutan di mana server dalam proses dimuat atau dibongkar, jangan panggil CoInitialize, CoInitializeEx, atau CoUninitialize dari fungsi DllMain .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 (termasuk Objbase.h) |
| Pustaka | Ole32.lib |
| DLL | Ole32.dll |