Bagikan melalui


Fungsi InitializeIpInterfaceEntry

Fungsi InitializeIpInterfaceEntry menginisialisasi anggota entri struktur MIB_IPINTERFACE_ROW dengan nilai default.

Sintaks

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parameter

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

Menampilkan nilai

InitializeIpInterfaceEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, InitializeIpInterfaceEntry mengembalikan salah satu kode kesalahan berikut:

Menampilkan 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.

Keterangan

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 yang lebih baru dari sistem operasi Windows.

Header

Netioapi.h (termasuk Netioapi.h)

Pustaka

Netio.lib

IRQL

< DISPATCH_LEVEL

Lihat juga

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry