Fungsi RtmGetRouteInfo (rtmv2.h)

Artikel
08/25/2023

Fungsi RtmGetRouteInfo mengembalikan informasi untuk rute yang ditentukan.

Sintaks

DWORD RtmGetRouteInfo(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   RouteInfo,
  [out] PRTM_NET_ADDRESS  DestAddress
);

Parameter

[in] RtmRegHandle

Tangani ke klien yang diperoleh dari panggilan sebelumnya ke RtmRegisterEntity.

[in] RouteHandle

Tangani ke rute untuk menemukan.

[out] RouteInfo

Jika penunjuk harus dikembalikan: Pada input, RouteInfo adalah penunjuk ke NULL. Pada output, RouteInfo menerima pointer ke rute; jika tidak, RouteInfo tetap tidak berubah.

Jika pointer tidak perlu dikembalikan: Pada input, RouteInfo adalah NULL.

[out] DestAddress

Jika penunjuk harus dikembalikan: Pada input, DestAddress adalah penunjuk ke NULL. Pada output, DestAddress menerima penunjuk ke struktur RTM_NET_ADDRESS tujuan; jika tidak, DestAddress tetap tidak berubah.

Jika pointer tidak perlu dikembalikan: Pada input, DestAddress adalah NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

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

Nilai	Makna
ERROR_INVALID_HANDLE	Handel tidak valid.

Keterangan

Ketika rute tidak lagi diperlukan, lepaskan dengan memanggil RtmReleaseRouteInfo.

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

RTM_NET_ADDRESS

RTM_ROUTE_INFO

RtmReleaseRouteInfo

Bagikan melalui