Fungsi RtmRegisterForChangeNotification (rtmv2.h)

Artikel
03/15/2023

Fungsi RtmRegisterForChangeNotification menginformasikan manajer tabel perutean bahwa klien harus menerima pemberitahuan perubahan untuk jenis perubahan yang ditentukan. Manajer tabel perutean mengembalikan handel pemberitahuan perubahan, yang harus digunakan klien saat meminta informasi perubahan setelah menerima pesan pemberitahuan perubahan.

Sintaks

DWORD RtmRegisterForChangeNotification(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_VIEW_SET       TargetViews,
  [in]  RTM_NOTIFY_FLAGS   NotifyFlags,
  [in]  PVOID              NotifyContext,
  [out] PRTM_NOTIFY_HANDLE NotifyHandle
);

Parameter

[in] RtmRegHandle

Tangani ke klien yang diperoleh dari panggilan sebelumnya ke RtmRegisterEntity.

[in] TargetViews

Menentukan tampilan untuk mendaftar pemberitahuan perubahan.

[in] NotifyFlags

Menentukan bendera yang menunjukkan jenis perubahan yang meminta pemberitahuan klien. Bendera berikut digunakan. (Bendera akan digabungkan menggunakan OR logis.)

Terus-menerus	Makna
RTM_CHANGE_TYPE_ALL	Beri tahu klien tentang perubahan apa pun ke tujuan.
RTM_CHANGE_TYPE_BEST	Beri tahu klien tentang perubahan pada rute terbaik saat ini, atau ketika rute terbaik berubah.
RTM_CHANGE_TYPE_FORWARDING	Beri tahu klien tentang perubahan rute terbaik yang memengaruhi penerusan, seperti perubahan hop berikutnya.
RTM_NOTIFY_ONLY_MARKED_DESTS	Beri tahu klien tentang perubahan pada tujuan yang telah ditandai klien. Jika bendera ini tidak ditentukan, ubah pesan pemberitahuan untuk semua tujuan akan dikirim.

[in] NotifyContext

Menentukan konteks pemberitahuan yang digunakan RTM_EVENT_CALLBACK untuk menunjukkan perubahan baru. Konteks pemberitahuan adalah parameter Context2 dari panggilan balik RTM_EVENT_CALLBACK .

[out] NotifyHandle

Menerima handel ke pemberitahuan perubahan. Handel harus digunakan saat memanggil RtmGetChangedDests.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter berisi informasi yang salah.
ERROR_NO_SYSTEM_RESOURCES	Tidak tersedia cukup sumber daya sistem untuk menyelesaikan operasi ini. Manajer tabel perutean telah melebihi jumlah maksimum pemberitahuan perubahan yang dapat di-cache.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk menyelesaikan operasi ini.
ERROR_NOT_SUPPORTED	Satu atau beberapa tampilan yang ditentukan tidak didukung.

Keterangan

Klien memanggil RtmMarkDestForChangeNotification saat mendaftar untuk perubahan pada tujuan tertentu.

Manajer tabel perutean menggunakan panggilan balik RTM_EVENT_CALLBACK , yang ditentukan ketika klien bernama RtmRegisterEntity, untuk memberi tahu klien ketika perubahan telah terjadi; klien harus memanggil RtmGetChangedDests untuk menerima informasi perubahan aktual.

Untuk kode sampel menggunakan fungsi ini, lihat Mendaftar Untuk Pemberitahuan Perubahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rtmv2.h
Pustaka	Rtm.lib
DLL	Rtm.dll

Lihat juga

RtmDeregisterFromChangeNotification

RtmGetChangedDests

RtmMarkDestForChangeNotification

Bagikan melalui