Fungsi CoRevokeClassObject (combaseapi.h)

Menginformasikan OLE bahwa objek kelas, yang sebelumnya terdaftar dengan fungsi CoRegisterClassObject , tidak lagi tersedia untuk digunakan.

Sintaks

HRESULT CoRevokeClassObject(
  [in] DWORD dwRegister
);

Parameter

[in] dwRegister

Token yang sebelumnya dikembalikan dari fungsi CoRegisterClassObject .

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Objek kelas berhasil dicabut.

Keterangan

Panggilan yang berhasil ke CoRevokeClassObject berarti bahwa objek kelas telah dihapus dari tabel objek kelas global (meskipun tidak merilis objek kelas). Jika klien lain masih memiliki penunjuk ke objek kelas dan telah menyebabkan jumlah referensi bertambah bertahap oleh panggilan ke IUnknown::AddRef, jumlah referensi tidak akan nol. Ketika ini terjadi, aplikasi dapat memperoleh manfaat jika panggilan berikutnya (dengan pengecualian addRef dan IUnknown::Release) yang jelas ke objek kelas gagal. Perhatikan bahwa CoRegisterClassObject memanggil AddRef dan CoRevokeClassObject memanggil Release, sehingga kedua fungsi membentuk pasanganRilisAddRef/.

Aplikasi objek harus memanggil CoRevokeClassObject untuk mencabut objek kelas terdaftar sebelum keluar dari program. Pelaksana objek kelas harus memanggil CoRevokeClassObject sebagai bagian dari urutan rilis. Anda harus secara khusus mencabut objek kelas bahkan ketika Anda telah menentukan nilai bendera REGCLS_SINGLEUSE dalam panggilan ke CoRegisterClassObject, yang menunjukkan bahwa hanya satu aplikasi yang dapat terhubung ke objek kelas.

Persyaratan

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

Lihat juga

CoGetClassObject

CoRegisterClassObject