_EVENT_CALLBACK fungsi panggilan balik (rtmv2.h)

Artikel
03/09/2024

Panggilan balik RTM_EVENT_CALLBACK digunakan oleh manajer tabel perutean untuk memberi tahu klien bahwa peristiwa yang ditentukan terjadi.

Sintaks

_EVENT_CALLBACK EventCallback;

DWORD EventCallback(
  RTM_ENTITY_HANDLE RtmRegHandle,
  RTM_EVENT_TYPE EventType,
  PVOID Context1,
  PVOID Context2
)
{...}

Parameter

RtmRegHandle

Tangani ke klien tempat manajer tabel perutean mengirim pemberitahuan.

EventType

Menentukan peristiwa di mana manajer tabel perutean memberi tahu klien. Nilai berikut digunakan.

Nilai	Makna
RTM_ENTITY_REGISTERED	Klien baru saja terdaftar di manajer tabel perutean.
RTM_ENTITY_DEREGISTERED	Klien baru saja tidak terdaftar.
RTM_ROUTE_EXPIRED	Sebuah rute telah kehabisan waktu.
RTM_CHANGE_NOTIFICATION	Pemberitahuan perubahan telah dibuat.

Context1

Untuk panggilan RTM_ENTITY_REGISTERED: Berisi handel ke entitas yang terdaftar.

Untuk panggilan RTM_ENTITY_DEREGISTERED: Berisi handel ke entitas yang tidak terdaftar.

Untuk panggilan RTM_ROUTE_EXPIRED: Berisi handel ke rute yang kehabisan waktu.

Untuk panggilan RTM_CHANGE_NOTIFICATION: Berisi handel ke pemberitahuan perubahan.

Context2

Untuk panggilan RTM_ENTITY_REGISTERED: Berisi penunjuk ke struktur RTM_ENTITY_INFO yang dirujuk oleh handel di Context1. Jika klien harus menyimpan informasi ini, klien harus menyalinnya ke struktur yang telah dialokasikan.

Untuk panggilan RTM_ENTITY_DEREGISTERED: Berisi penunjuk ke struktur RTM_ENTITY_INFO yang dimaksud oleh handel dalam Context1. Jika klien harus menyimpan informasi ini, klien harus menyalinnya ke struktur yang telah dialokasikan.

Untuk panggilan RTM_ROUTE_EXPIRED: Berisi penunjuk ke struktur RTM_ROUTE_INFO yang dirujuk oleh handel dalam Context1. Jika klien harus menyimpan informasi ini, klien harus menyalinnya ke struktur yang telah dialokasikan.

Untuk panggilan RTM_CHANGE_NOTIFICATION: Berisi konteks pemberitahuan yang diberikan kepada klien oleh panggilan sebelumnya ke RtmRegisterForChangeNotification.

Nilai kembali

Jika manajer tabel perutean mengeluarkan panggilan balik RTM_ROUTE_EXPIRED, dan klien kembali ke manajer tabel perutean nilai yang ERROR_NOT_SUPPORTED, manajer tabel perutean akan menghapus rute dari tabel perutean.

Semua kesalahan lain yang dikembalikan oleh klien diabaikan.

Keterangan

Setelah klien mendaftar untuk pemberitahuan perubahan, manajer tabel perutean menggunakan panggilan balik ini untuk memberi tahu klien tentang peristiwa.

Jika klien menerima RTM_EVENT_CALLBACK untuk peristiwa RTM_ENTITY_REGISTERED atau RTM_ENTITY_DEREGISTERED, klien tidak boleh melakukan panggilan ke RtmRegisterEntity, RtmDeregisterEntity, atau RtmGetRegisteredEntities dalam konteks panggilan balik ini.

Jika klien menerima RTM_EVENT_CALLBACK untuk peristiwa RTM_CHANGE_NOTIFICATION, klien tidak boleh memanggil RtmRegisterForChangeNotification dalam konteks panggilan balik ini.

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

Lihat juga

RTM_EVENT_TYPE

RtmRegisterEntity

Share via