Fungsi RpcServerUnsubscribeForNotification (rpcasync.h)

Artikel
03/15/2023

Fungsi RpcServerUnsubscribeForNotification berhenti berlangganan server dari pemberitahuan RPC.

Sintaks

RPC_STATUS RpcServerUnsubscribeForNotification(
  [in]  RPC_BINDING_HANDLE Binding,
  [in]  RPC_NOTIFICATIONS  Notification,
  [out] unsigned long      *NotificationsQueued
);

Parameter

[in] Binding

RPC_BINDING_HANDLE struktur yang berisi handel pengikatan untuk panggilan RPC saat ini yang ditentukan dalam panggilan sebelumnya ke RpcServerSubscribeForNotification. Jika fungsi ini dipanggil pada utas yang sama dengan yang telah dikirimkan RPC panggilan, parameter ini dapat diatur ke NULL; jika tidak, handel pengikatan eksplisit harus diteruskan dalam parameter ini.

[in] Notification

Nilai dari enumerasi RPC_NOTIFICATIONS yang menentukan jenis pemberitahuan yang diminta dari RPC oleh server. Pemberitahuan harus berhenti berlangganan satu per satu, beberapa nilai tidak didukung.

Windows Vista: Saat ini, hanya RpcNotificationClientDisconnect dan RpcNotificationCallCancel yang didukung. Jika ada nilai lain yang ditentukan untuk parameter ini, kode kesalahan RPC_S_CANNOT_SUPPORT dikembalikan.

[out] NotificationsQueued

Penunjuk yang diperlukan ke nilai yang menerima jumlah pemberitahuan bahwa runtime RPC mengantre untuk panggilan RPC yang ditentukan. Pointer harus disediakan; itu tidak opsional.

Kode Anda harus melacak jumlah pemberitahuan yang diterimanya. Saat berhenti berlangganan pemberitahuan RPC, Anda harus memeriksa apakah jumlah pemberitahuan yang diantrekan runtime RPC cocok dengan jumlah pemberitahuan yang Anda terima. Jika angka tidak cocok, beberapa pemberitahuan masih bisa masuk di utas lain. Anda harus menunda pembersihan status pemberitahuan hingga Anda menerima semua pemberitahuan masuk.

Nilai kembali

Fungsi ini mengembalikan RPC_S_OK pada keberhasilan; jika tidak, kode kesalahan RPC_S_* dikembalikan.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

RpcServerUnsubscribeForNotification harus dipanggil untuk setiap handel pengikatan RPC yang juga memiliki RpcServerSubscribeForNotification yang dipanggil untuk panggilan RPC terkait. API ini harus dipanggil sebelum panggilan RPC terkait selesai; jika tidak, hasilnya tidak ditentukan dan dapat menyebabkan ketidakstabilan aplikasi.

Pemberitahuan yang tidak diambil dapat diambil setelah API ini kembali.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcasync.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RpcServerSubscribeForNotification

Bagikan melalui