Fungsi CoSetCancelObject (combaseapi.h)

Mengatur (mendaftar) atau mengatur ulang (membatalkan pendaftaran) objek pembatalan untuk digunakan selama operasi pembatalan berikutnya pada utas saat ini.

Sintaks

HRESULT CoSetCancelObject(
  [in, optional] IUnknown *pUnk
);

Parameter

[in, optional] pUnk

Arahkan ke antarmuka IUnknown pada objek pembatalan yang akan diatur atau diatur ulang pada utas saat ini. Jika parameter ini NULL, objek pembatalan paling atas diatur ulang.

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 pembatalan berhasil diatur atau direset.
E_ACCESSDENIED	Objek pembatalan tidak dapat diatur atau direset saat ini karena blok pada operasi pembatalan.

Keterangan

Untuk objek yang mendukung marshaling standar, objek proksi mulai melakukan marsekal panggilan metode dengan memanggil CoSetCancelObject untuk mendaftarkan objek pembatalan untuk utas saat ini.

CoSetCancelObject memanggil QueryInterface untuk ICancelMethodCalls pada objek pembatalan. Jika objek pembatalan tidak mengimplementasikan ICancelMethodCalls, CoSetCancelObject gagal dengan E_NOINTERFACE. Untuk menonaktifkan operasi pembatalan pada antarmuka custom-marshaled, implementasi ICancelMethodCalls::Cancel tidak boleh melakukan apa pun selain mengembalikan E_NOTIMPL, E_FAIL, atau beberapa nilai lain yang sesuai.

CoSetCancelObject memanggil AddRef pada objek yang didaftarkannya dan Rilis pada objek yang tidak terdaftar.

CoSetCancelObject tidak mengatur atau mengatur ulang objek pembatalan untuk metode 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

Lihat juga

ICancelMethodCalls