Fungsi InitializeIpInterfaceEntry

Fungsi InitializeIpInterfaceEntry menginisialisasi anggota entri struktur MIB_IPINTERFACE_ROW dengan nilai default.

Sintaksis

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parameter

• Baris [masuk, keluar]
  Penunjuk ke struktur MIB_IPINTERFACE_ROW untuk diinisialisasi. Pada pengembalian yang berhasil, bidang dalam parameter ini diinisialisasi dengan informasi default untuk antarmuka di komputer lokal.

Mengembalikan nilai

InitializeIpInterfaceEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, InitializeIpInterfaceEntry 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
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Pada output, anggota struktur MIB_IPINTERFACE_ROW yang ditunjukkan parameter Baris diinisialisasi sebagai berikut.

• Keluarga
  Atur ke AF_UNSPEC.

• InterfaceLuid
  Atur ke nilai yang tidak ditentukan.

• Semua anggota lainnya
  Atur ke nol.

Driver Anda harus menggunakan fungsi InitializeIpInterfaceEntry untuk menginisialisasi bidang entri struktur MIB_IPINTERFACE_ROW dengan nilai default. Driver kemudian dapat mengubah bidang dalam entri MIB_IPINTERFACE_ROW yang ingin dimodifikasi, lalu memanggil fungsi SetIpInterfaceEntry.

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

Lihat juga

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry