Fungsi CoCancelCall (combaseapi.h)

Meminta pembatalan panggilan metode DCOM keluar yang tertunda pada utas tertentu.

Sintaks

HRESULT CoCancelCall(
  [in] DWORD dwThreadId,
  [in] ULONG ulTimeout
);

Parameter

[in] dwThreadId

Pengidentifikasi utas tempat panggilan DCOM yang tertunda akan dibatalkan. Jika parameter ini adalah 0, panggilan ada di utas saat ini.

[in] ulTimeout

Jumlah detik CoCancelCall menunggu server menyelesaikan panggilan keluar setelah klien meminta pembatalan.

Nilai kembali

Fungsi ini dapat mengembalikan nilai pengembalian standar E_FAIL, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Permintaan pembatalan dibuat.
E_NOINTERFACE	Tidak ada objek pembatalan yang sesuai dengan utas yang ditentukan.
CO_E_CANCEL_DISABLED	Pembatalan panggilan tidak diaktifkan pada utas yang ditentukan.
RPC_E_CALL_COMPLETE	Panggilan selesai selama interval waktu habis.
RPC_E_CALL_CANCELED	Panggilan sudah dibatalkan.

Keterangan

CoCancelCall memanggil CoGetCancelObject lalu ICancelMethodCalls::Cancel pada objek pembatalan untuk panggilan yang dijalankan.

Fungsi ini tidak menemukan objek pembatalan untuk panggilan asinkron.

Server objek dapat menentukan apakah panggilan telah dibatalkan dengan memanggil CoTestCancel secara berkala. Jika panggilan telah dibatalkan, server objek harus membersihkan dan mengembalikan kontrol ke klien.

Persyaratan

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

Lihat juga

CotestCancel