IRunningObjectTable::Cabut metode (objidl.h)

Menghapus entri dari tabel objek yang sedang berjalan (ROT) yang sebelumnya didaftarkan oleh panggilan ke IRunningObjectTable::Register.

Sintaks

HRESULT Revoke(
  [in] DWORD dwRegister
);

Parameter

[in] dwRegister

Pengidentifikasi entri ROT yang akan dicabut.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG dan S_OK.

Keterangan

Metode ini membatalkan efek panggilan ke IRunningObjectTable::Register, menghapus moniker dan pointer ke objek yang diidentifikasi oleh moniker tersebut.

Catatan untuk Penelepon

Penyedia moniker (mengeluarkan moniker yang mengidentifikasi objeknya untuk membuatnya dapat diakses oleh orang lain) harus memanggil metode Cabut untuk mencabut pendaftaran objeknya ketika berhenti berjalan. Sebelumnya harus disebut IRunningObjectTable::Register dan menyimpan pengidentifikasi yang dikembalikan oleh metode tersebut; ini menggunakan pengidentifikasi tersebut saat memanggil Cabut.

Jenis penyedia moniker yang paling umum adalah sumber tautan dokumen majemuk. Ini termasuk aplikasi server yang mendukung penautan ke dokumen mereka (atau bagian dari dokumen) dan aplikasi kontainer yang mendukung penautan ke penyematan dalam dokumen mereka. Aplikasi server yang tidak mendukung penautan juga dapat menggunakan ROT untuk bekerja sama dengan aplikasi kontainer yang mendukung penautan ke penyematan.

Jika Anda menulis aplikasi kontainer, Anda harus mencabut pendaftaran dokumen saat dokumen ditutup. Anda juga harus mencabut pendaftaran dokumen sebelum mendaftarkannya kembali saat diganti namanya.

Jika Anda menulis aplikasi server, Anda harus mencabut pendaftaran objek ketika objek ditutup. Anda juga harus mencabut pendaftaran objek sebelum mendaftarkannya kembali ketika dokumen kontainernya diganti namanya (lihat IOleObject::SetMoniker).

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	objidl.h

Lihat juga

IRunningObjectTable