IVdsService::Metode unadvise (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Membatalkan pendaftaran antarmuka IVdsAdviseSink penelepon sehingga penelepon tidak lagi menerima pemberitahuan dari layanan VDS.

Sintaks

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parameter

[in] dwCookie

Cookie yang dikembalikan oleh metode IVdsService::Advise ketika antarmuka IVdsAdviseSink terdaftar.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil diselesaikan.
VDS_E_BAD_COOKIE 0x80042411L	Cookie tidak ada.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir sampai inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Gunakan metode Saran untuk mendaftarkan antarmuka IVdsAdviseSink aplikasi VDS Anda untuk menerima pemberitahuan dari VDS. Advise mengembalikan cookie, yang harus Anda teruskan kembali sebagai parameter ke metode Unadvise .

Catatan Aplikasi yang memanggil Advise akhirnya harus memanggil Unadvise. Idealnya, itu harus memanggil Unadvise segera setelah tidak perlu lagi menerima pemberitahuan.

Metode Tidak Diawasi mungkin tidak segera kembali, karena menunggu kunci untuk memperbarui daftar aplikasi klien terdaftar dan menunggu utas pemberitahuan yang mengirim pemberitahuan klien keluar. Jika ada pemberitahuan luar biasa yang akan dikirim ke aplikasi Anda, utas pemberitahuan mencoba mengirimnya sebelum keluar.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Pustaka	Uuid.lib

Lihat juga

Bagikan melalui