Fungsi GetIpPathEntry
Fungsi GetIpPathEntry mengambil informasi untuk entri jalur IP di komputer lokal.
Sintaksis
NETIOAPI_API GetIpPathEntry(
_Inout_ PMIB_IPPATH_ROW Row
);
Parameter
-
Baris [masuk, keluar]
Penunjuk ke entri struktur MIB_IPPATH_ROW untuk entri jalur IP. Pada pengembalian yang berhasil, struktur ini diperbarui dengan properti untuk entri jalur IP.
Mengembalikan nilai
GetIpPathEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetIpPathEntry mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris, anggota si_family di Tujuan anggota struktur MIB_IPPATH_ROW yang ditunjukkan parameter Baris tidak diatur ke AF_INET atau AF_INET6, atau InterfaceLuid dan InterfaceIndex anggota struktur MIB_IPPATH_ROW tidak ditentukan. Kesalahan ini juga dikembalikan jika anggota si_family di anggota Sumber dari struktur MIB_IPPATH_ROW tidak cocok dengan keluarga alamat IP tujuan dan si_family untuk alamat IP sumber tidak ditentukan sebagai AF_UNSPEC. |
| STATUS_NOT_FOUND | Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_IPPATH_ROW yang ditunjuk oleh parameter Row. |
| STATUS_NOT_SUPPORTED | Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 yang terletak di komputer lokal dan alamat IPv4 ditentukan dalam Sumber dan tujuan anggota struktur MIB_IPPATH_ROW yang ditunjuk parameter Baris, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan dalam Sumber dan anggota Tujuan. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Fungsi GetIpPathEntry digunakan untuk mengambil entri struktur MIB_IPPATH_ROW.
Pada input, driver Anda harus menginisialisasi anggota struktur MIB_IPPATH_ROW berikut yang ditunjuk oleh parameter Baris.
Tujuan
Atur ke alamat dan keluarga IPv4 atau IPv6 yang valid.Sumber
Atur keluarga alamat yang ditentukan dalam anggota Sumber ke keluarga alamat IP tujuan yang ditentukan dalam anggota Tujuan, atau ke AF_UNSPEC.InterfaceLuid atau InterfaceIndex
Anggota ini digunakan dalam urutan yang tercantum sebelumnya. Jadi jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Pada output, ketika panggilan berhasil, GetIpPathEntry mengambil properti lain untuk entri jalur IP dan mengisi struktur MIB_IPPATH_ROW yang ditunjuk oleh parameter Baris.
Driver Anda dapat memanggil fungsiGetIpPathTable untuk menghitung entri jalur IP di komputer lokal.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |