Fungsi CoEnableCallCancellation (combaseapi.h)

Mengaktifkan pembatalan panggilan sinkron pada utas panggilan.

Syntax

HRESULT CoEnableCallCancellation(
  [in, optional] LPVOID pReserved
);

Parameter-parameternya

[in, optional] pReserved

Parameter ini dicadangkan dan harus NULL.

Mengembalikan nilai

Fungsi ini dapat mengembalikan nilai pengembalian standar S_OK, E_FAIL, E_INVALIDARG, dan E_OUTOFMEMORY.

Komentar

Ketika pembatalan panggilan diaktifkan pada utas, panggilan sinkron marshaled dari utas tersebut ke objek di komputer yang sama dapat mengalami penurunan performa yang serius. Secara default, panggilan sinkron tidak dapat dibatalkan, meskipun objek pembatalan tersedia. Untuk mengaktifkan pembatalan panggilan, Anda harus memanggil CoEnableCallCancellation terlebih dahulu.

Kecuali Anda ingin mengaktifkan pembatalan panggilan pada utas setiap saat, Anda harus memasangkan panggilan ke CoEnableCallCancellation dengan panggilan ke CoDisableCallCancellation. Pembatalan panggilan dinonaktifkan hanya jika CoDisableCallCancellation telah dipanggil sekali untuk setiap kali CoEnableCallCancellation berhasil dipanggil.

Panggilan akan dapat dibatalkan atau tidak tergantung pada status utas pada saat panggilan dilakukan. Kemudian mengaktifkan atau menonaktifkan pembatalan panggilan tidak berpengaruh pada panggilan apa pun yang tertunda di utas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	combaseapi.h (termasuk Objbase.h)
Library	Ole32.lib
DLL	Ole32.dll

Lihat juga

CoEnableCallCancellation

ICancelMethodCalls