Fungsi CoLeaveServiceDomain (comsvcs.h)
Digunakan untuk meninggalkan kode yang menggunakan layanan COM+.
Sintaks
void CoLeaveServiceDomain(
[in] IUnknown *pUnkStatus
);
Parameter
[in] pUnkStatus
Jika Anda ingin mengetahui status transaksi yang diselesaikan oleh panggilan, ini harus menjadi penunjuk ke antarmuka IUnknown objek yang mengimplementasikan antarmuka ITransactionStatus . Jika kode tertutup tidak menggunakan transaksi atau jika Anda tidak perlu mengetahui status transaksi, parameter ini harus NULL. Parameter ini diabaikan jika bukan NULL dan jika tidak ada transaksi yang digunakan di domain layanan.
Nilai kembali
Tidak ada
Keterangan
Kode yang diapit antara panggilan ke CoEnterServiceDomain dan CoLeaveServiceDomain berjalan dalam konteksnya sendiri dan berperilaku seolah-olah itu adalah metode yang dipanggil dari objek yang dibuat dalam konteks.
CoLeaveServiceDomain memicu server dan kemudian kebijakan sisi klien seolah-olah panggilan metode kembali. Konteks saat ini kemudian muncul dari tumpukan konteks, dan konteks yang berjalan ketika CoEnterServiceDomain dipanggil menjadi konteks saat ini.
Karena desainnya yang efisien dan karena tidak ada thread marshaling yang terlibat, menggunakan CoEnterServiceDomain dan CoLeaveServiceDomain melibatkan overhead yang berkurang secara signifikan dibandingkan dengan panggilan metode yang setara.
CoEnterServiceDomain dan CoLeaveServiceDomain sangat berguna dalam aplikasi, yang dapat menggunakan fungsi-fungsi ini untuk mengakses layanan COM+ tanpa perlu membuat komponen untuk melakukannya.
Pasangan CoEnterServiceDomain dan CoLeaveServiceDomain dapat disarangkan. Terserah pengguna untuk memastikan bahwa pasangan panggilan seimbang sehingga setiap panggilan ke CoLeaveServiceDomain cocok dengan panggilan sebelumnya ke CoEnterServiceDomain.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | comsvcs.h |
| Pustaka | ComSvcs.lib |
| DLL | ComSvcs.dll |