PSTART_PROTOCOL fungsi panggilan balik (routprot.h)

  • Artikel

Fungsi StartProtocol menginisialisasi fungsionalitas protokol perutean. Manajer router menggunakan fungsi ini untuk meneruskan parameter konfigurasi global protokol perutean dan satu set titik entri API. Protokol menggunakan titik masuk ini untuk memanggil ke manajer router.

Sintaks

PSTART_PROTOCOL PstartProtocol;

DWORD PstartProtocol(
  [in] HANDLE NotificationEvent,
  [in] PSUPPORT_FUNCTIONS SupportFunctions,
  [in] LPVOID GlobalInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parameter

[in] NotificationEvent

Menangani ke objek peristiwa. Protokol perutean menandakan peristiwa ini ketika ingin manajer router mengambil pesan asinkron dari antrean yang dikelola oleh protokol.

[in] SupportFunctions

Penunjuk ke struktur SUPPORT_FUNCTIONS . Bidang struktur ini adalah penunjuk ke fungsi di manajer router. Fungsi-fungsi ini memungkinkan protokol untuk mengakses informasi yang mencakup protokol perutean.

[in] GlobalInfo

Penunjuk ke global yang ditentukan protokol, dibandingkan dengan informasi konfigurasi khusus antarmuka. Informasi ini bersifat pribadi untuk protokol perutean.

[in] StructureVersion

Menentukan versi struktur informasi yang ditujukan oleh parameter GlobalInfo . Dalam beberapa kasus, ini sama dengan versi protokol perutean.

[in] StructureSize

Menentukan ukuran masing-masing struktur informasi yang ditujukan oleh parameter GlobalInfo . Karena beberapa struktur informasi berisi anggota panjang variabel, protokol perutean tidak selalu dapat menentukan ukuran informasi dari versi.

[in] StructureCount

Menentukan hitungan jumlah struktur informasi yang ditujukan oleh parameter GlobalInfo . Parameter ini selalu satu.

Mengembalikan nilai

Jika fungsi berhasil, dan protokol siap menerima informasi antarmuka, nilai yang dikembalikan NO_ERROR.

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

Nilai Deskripsi
ERROR_CAN_NOT_COMPLETE
 Upaya untuk menginisialisasi protokol perutean gagal.
ERROR_INVALID_PARAMETER
 Salah satu parameter yang ditujukan oleh parameter GlobalInfo tidak valid.
 
 

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 routprot.h

Lihat juga

GetEventMessage

Fungsi Antarmuka Protokol Perutean

Referensi Antarmuka Protokol Perutean

SUPPORT_FUNCTIONS

StopProtocol