RtmEnumerateGetNextRoute (Fungsi RtmEnumerateGetNextRoute)

[API ini telah digantikan oleh Api Manajer Tabel Perutean Versi 2 dan tidak akan tersedia di luar Windows Server 2003. Aplikasi harus menggunakan API Manajer Tabel Perutean Versi 2.]

Fungsi RtmEnumerateGetNextRoute mengembalikan entri rute berikutnya dalam enumerasi yang dimulai oleh panggilan ke RtmCreateEnumerationHandle.

Sintaks

DWORD RtmEnumerateGetNextRoute(
  _In_  HANDLE EnumerationHandle,
  _Out_ PVOID  Route
);

Parameter

EnumerationHandle [in]

Menangani yang mengidentifikasi enumerasi dan menentukan cakupannya. Dapatkan handel ini dengan memanggil RtmCreateEnumerationHandle.

Rute [keluar]

Arahkan ke struktur rute khusus keluarga protokol ( RTM_IP_ROUTE atau RTM_IPX_ROUTE). Struktur ini akan menerima rute berikutnya dalam enumerasi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Nilai	Deskripsi
ERROR_INVALID_HANDLE	Parameter EnumerationHandle tidak valid.
ERROR_NO_MORE_ROUTES	Tidak ada lagi rute dalam enumerasi.
ERROR_NO_SYSTEM_RESOURCES	Tidak ada cukup sumber daya untuk melakukan operasi.

Keterangan

Meskipun rute tidak dikembalikan dalam urutan tertentu, setiap rute dalam enumerasi dikembalikan hanya sekali.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Akhir dukungan server	Windows Server 2003
Header	Rtm.h
Pustaka	Rtm.lib
DLL	Rtm.dll

Lihat juga

Referensi Manajer Tabel Perutean Versi 1

Fungsi Manajer Tabel Perutean Versi 1

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle