Fungsi CoUninitialize (combaseapi.h)

  • Artikel

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

Lihat juga

Koinisialisasi

CoInitializeEx

OleUninitialize