Fungsi CoGetCancelObject (combaseapi.h)

Artikel
02/24/2024

Mendapatkan penunjuk ke antarmuka kontrol panggilan, biasanya ICancelMethodCalls, pada objek pembatalan yang sesuai dengan panggilan metode COM keluar yang tertunda pada utas klien yang sama atau lain.

Sintaks

HRESULT CoGetCancelObject(
  [in]  DWORD  dwThreadId,
  [in]  REFIID iid,
  [out] void   **ppUnk
);

Parameter

[in] dwThreadId

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

[in] iid

Pengidentifikasi unik global antarmuka pada objek pembatalan agar panggilan dibatalkan. Argumen ini biasanya IID_ICancelMethodCalls.

[out] ppUnk

Menerima alamat pointer ke antarmuka yang ditentukan oleh riid.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Objek kontrol panggilan berhasil diambil.
E_NOINTERFACE	Objek tempat panggilan dijalankan tidak mendukung antarmuka yang ditentukan oleh riid.

Keterangan

Jika dua panggilan atau lebih tertunda pada utas yang sama melalui panggilan berlapis, ID utas mungkin tidak cukup untuk mengidentifikasi panggilan yang akan dibatalkan. Dalam hal ini, CoGetCancelObject mengembalikan antarmuka pembatalan yang sesuai dengan panggilan terdahulu yang tertunda pada utas dan telah mendaftarkan objek pembatalan.

Fungsi ini tidak menemukan objek pembatalan untuk panggilan asinkron.

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui