IVdsService::Metode saran (vds.h)

Artikel
03/03/2024

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Mendaftarkan antarmuka IVdsAdviseSink penelepon dengan VDS sehingga pemanggil menerima pemberitahuan dari layanan VDS.

Sintaks

HRESULT Advise(
  [in]  IVdsAdviseSink *pSink,
  [out] DWORD          *pdwCookie
);

Parameter

[in] pSink

Penunjuk ke antarmuka IVdsAdviseSink .

[out] pdwCookie

Pointer ke cookie yang nantinya dapat digunakan untuk membatalkan pendaftaran antarmuka.

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. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Pendaftaran berhasil diselesaikan.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir hingga inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Untuk menerima pemberitahuan dari layanan VDS, aplikasi Anda harus mengimplementasikan antarmuka IVdsAdviseSink dan menggunakan metode Saran untuk mendaftarkan antarmuka.

Untuk berhenti menerima pemberitahuan dari layanan VDS, gunakan metode IVdsService::Unadvise untuk membatalkan pendaftaran antarmuka IVdsAdviseSink .

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

Untuk menerima pemberitahuan dari penyedia perangkat lunak dan perangkat keras yang mendasar, VDS meneruskan fungsi panggilan balik pemberitahuan ke setiap penyedia sebagai parameter metode IVdsProviderPrivate::OnLoad .

Persyaratan

Persyaratan	Nilai
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

IVdsAdviseSink

IVdsProviderPrivate::OnLoad

IVdsService

Pemberitahuan VDS

Bagikan melalui