Fungsi CoIncrementMTAUsage (combaseapi.h)

Menjaga dukungan MTA tetap aktif ketika tidak ada utas MTA yang berjalan.

Sintaks

HRESULT CoIncrementMTAUsage(
  [out] CO_MTA_USAGE_COOKIE *pCookie
);

Parameter

[out] pCookie

Alamat variabel PVOID yang menerima cookie untuk fungsi CoDecrementMTAUsage , atau NULL jika panggilan gagal.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi CoIncrementMTAUsage memungkinkan klien untuk membuat pekerja MTA dan menunggu mereka selesai sebelum keluar dari proses.

Fungsi CoIncrementMTAUsage memastikan bahwa sistem tidak membebaskan sumber daya yang terkait dengan dukungan MTA., bahkan jika jumlah utas MTA masuk ke 0.

Jika berhasil, panggil CoDecrementMTAUsage sekali saja. Jika gagal, jangan panggil fungsi CoDecrementMTAUsage .

Jangan panggil CoIncrementMTAUsage selama proses matikan atau di dalam dllmain. Anda dapat memanggil CoIncrementMTAUsage sebelum panggilan untuk memulai proses matikan.

Anda dapat memanggil CoIncrementMTAUsage dari satu utas dan CoDecrementMTAUsage dari yang lain selama cookie yang sebelumnya dikembalikan oleh CoIncrementMTAUsage diteruskan ke CoDecrementMTAUsage.

CoIncrementMTAUsage membuat MTA, jika MTA belum ada. CoIncrementMTAUsage menempatkan utas saat ini ke MTA, jika utas saat ini belum ada di apartemen

Anda dapat menggunakan CoIncrementMTAUsage saat:

• Anda ingin server menjaga MTA tetap hidup bahkan ketika semua utas pekerja diam.
• Implementasi API Anda mengharuskan COM untuk diinisialisasi, tetapi tidak memiliki informasi tentang apakah utas saat ini sudah ada di apartemen, dan tidak memerlukan utas saat ini untuk masuk ke apartemen tertentu.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	combaseapi.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CoDecrementMTAUsage