IPart::Metode UnregisterControlChangeCallback (devicetopology.h)

Metode UnregisterControlChangeCallback menghapus pendaftaran antarmuka IControlChangeNotify yang sebelumnya didaftarkan klien melalui panggilan ke metode IPart::RegisterControlChangeCallback .

Sintaks

HRESULT UnregisterControlChangeCallback(
  [in] IControlChangeNotify *pNotify
);

Parameter

[in] pNotify

Arahkan ke antarmuka IControlChangeNotify yang pendaftarannya akan dihapus. Klien meneruskan penunjuk antarmuka yang sama ini ke objek bagian dalam panggilan sebelumnya ke metode IPart::RegisterControlChangeCallback . Jika metode UnregisterControlChangeCallback berhasil, metode Rilis memanggil metode Rilis pada antarmuka IControlChangeNotify klien.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Pointer pNotify adalah NULL.
E_NOTFOUND	Instans antarmuka *pNotify saat ini tidak terdaftar.

Keterangan

Sebelum klien merilis referensi terakhirnya ke antarmuka IControlChangeNotify , klien harus memanggil UnregisterControlChangeCallback untuk membatalkan pendaftaran antarmuka. Jika tidak, aplikasi membocorkan sumber daya yang disimpan oleh objek IControlChangeNotify dan IPart . Perhatikan bahwa metode IPart::RegisterControlChangeCallback memanggil metode IControlChangeNotify::AddRef klien, dan UnregisterControlChangeCallback memanggil metode IControlChangeNotify::Release . Jika klien melakukan kesalahan dengan merilis referensinya ke antarmuka IControlChangeNotify sebelum memanggil UnregisterControlChangeCallback, objek IPart tidak pernah merilis referensinya ke antarmuka IControlChangeNotify . Misalnya, implementasi IControlChangeNotify yang dirancang dengan buruk mungkin memanggil UnregisterControlChangeCallback dari destruktor untuk objek IControlChangeNotify . Dalam hal ini, klien tidak akan memanggil UnregisterControlChangeCallback sampai objek IPart merilis referensinya ke antarmuka IControlChangeNotify , dan objek IPart tidak akan merilis referensinya ke antarmuka IControlChangeNotify sampai klien memanggil UnregisterControlChangeCallback. Untuk informasi selengkapnya tentang metode AddRef dan Rilis , lihat diskusi antarmuka IUnknown dalam dokumentasi Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	devicetopology.h

Lihat juga

Antarmuka IControlChangeNotify

Antarmuka IPart

IPart::RegisterControlChangeCallback