struktur MIB_IF_ROW2 (netioapi.h)
Struktur MIB_IF_ROW2 menyimpan informasi tentang antarmuka tertentu.
Sintaks
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface : 1;
BOOLEAN FilterInterface : 1;
BOOLEAN ConnectorPresent : 1;
BOOLEAN NotAuthenticated : 1;
BOOLEAN NotMediaConnected : 1;
BOOLEAN Paused : 1;
BOOLEAN LowPower : 1;
BOOLEAN EndPointInterface : 1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Anggota
InterfaceLuid
Jenis: NET_LUID
Pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan.
InterfaceIndex
Jenis: NET_IFINDEX
Indeks yang mengidentifikasi antarmuka jaringan. Nilai indeks ini dapat berubah ketika adaptor jaringan dinonaktifkan lalu diaktifkan, dan tidak boleh dianggap persisten.
InterfaceGuid
Jenis: GUID
GUID untuk antarmuka jaringan.
Alias[IF_MAX_STRING_SIZE + 1]
Jenis: WCHAR[IF_MAX_STRING_SIZE + 1]
String Unicode yang dihentikan NULL yang berisi nama alias antarmuka jaringan.
Description[IF_MAX_STRING_SIZE + 1]
Jenis: WCHAR[IF_MAX_STRING_SIZE + 1]
String Unicode yang dihentikan NULL yang berisi deskripsi antarmuka jaringan.
PhysicalAddressLength
Jenis: ULONG
Panjangnya, dalam byte, dari alamat perangkat keras fisik yang ditentukan oleh anggota PhysicalAddress .
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Jenis: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Alamat perangkat keras fisik adapter untuk antarmuka jaringan ini.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Jenis: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Alamat perangkat keras fisik permanen adapter untuk antarmuka jaringan ini.
Mtu
Jenis: ULONG
Ukuran unit transmisi maksimum (MTU), dalam byte, untuk antarmuka jaringan ini.
Type
Jenis: IFTYPE
Jenis antarmuka seperti yang didefinisikan oleh Internet Assigned Names Authority (IANA). Untuk informasi selengkapnya, lihat http://www.iana.org/assignments/ianaiftype-mib. Nilai yang mungkin untuk jenis antarmuka tercantum dalam file header Ipifcons.h .
Tabel di bawah ini mencantumkan nilai umum untuk jenis antarmuka meskipun banyak nilai lain dimungkinkan.
TunnelType
Jenis: TUNNEL_TYPE
Metode enkapulasi yang digunakan oleh terowongan jika anggota JenisIF_TYPE_TUNNEL. Jenis terowongan ditentukan oleh Internet Assigned Names Authority (IANA). Untuk informasi selengkapnya, lihat http://www.iana.org/assignments/ianaiftype-mib. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi TUNNEL_TYPE yang ditentukan dalam file header Ifdef.h .
MediaType
Jenis: NDIS_MEDIUM
Jenis media NDIS untuk antarmuka. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NDIS_MEDIUM yang ditentukan dalam file header Ntddndis.h .
PhysicalMediumType
Jenis: NDIS_PHYSICAL_MEDIUM
Jenis sedang fisik NDIS. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NDIS_PHYSICAL_MEDIUM yang ditentukan dalam file header Ntddndis.h .
AccessType
Jenis: NET_IF_ACCESS_TYPE
Jenis akses antarmuka. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NET_IF_ACCESS_TYPE yang ditentukan dalam file header Ifdef.h .
DirectionType
Jenis: NET_IF_DIRECTION_TYPE
Jenis arah antarmuka. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NET_IF_DIRECTION_TYPE yang ditentukan dalam file header Ifdef.h .
InterfaceAndOperStatusFlags
Sekumpulan bendera yang menyediakan informasi tentang antarmuka. Bendera ini dikombinasikan dengan operasi OR bitwise. Jika tidak ada bendera yang berlaku, maka anggota ini diatur ke nol.
InterfaceAndOperStatusFlags.HardwareInterface
Jenis: BOOLEAN Atur apakah antarmuka jaringan adalah untuk perangkat keras.
InterfaceAndOperStatusFlags.FilterInterface
Jenis: BOOLEAN Atur apakah antarmuka jaringan adalah untuk modul filter.
InterfaceAndOperStatusFlags.ConnectorPresent
Jenis: BOOLEAN Atur apakah konektor ada di antarmuka jaringan. Nilai ini diatur jika ada adaptor jaringan fisik.
InterfaceAndOperStatusFlags.NotAuthenticated
Jenis: BOOLEAN Atur jika port default untuk antarmuka jaringan tidak diautentikasi. Jika antarmuka jaringan tidak diautentikasi oleh target, maka antarmuka jaringan tidak dalam mode operasional. Meskipun ini berlaku untuk koneksi jaringan kabel dan nirkabel, autentikasi lebih umum untuk koneksi jaringan nirkabel.
InterfaceAndOperStatusFlags.NotMediaConnected
Jenis: BOOLEAN Atur jika antarmuka jaringan tidak dalam status terhubung ke media. Jika kabel jaringan dilepas untuk jaringan berkabel, ini akan diatur. Untuk jaringan nirkabel, ini disetel untuk adaptor jaringan yang tidak tersambung ke jaringan.
InterfaceAndOperStatusFlags.Paused
Jenis: BOOLEAN Atur apakah tumpukan jaringan untuk antarmuka jaringan berada dalam status dijeda atau dijeda. Ini tidak berarti bahwa komputer dalam keadaan hibernasi.
InterfaceAndOperStatusFlags.LowPower
Jenis: BOOLEAN Atur jika antarmuka jaringan dalam status daya rendah.
InterfaceAndOperStatusFlags.EndPointInterface
Jenis: BOOLEAN Atur apakah antarmuka jaringan adalah perangkat titik akhir dan bukan antarmuka jaringan sejati yang tersambung ke jaringan. Ini dapat diatur oleh perangkat seperti ponsel pintar yang menggunakan infrastruktur jaringan untuk berkomunikasi ke PC tetapi tidak menyediakan konektivitas ke jaringan eksternal. Wajib bagi jenis perangkat ini untuk mengatur bendera ini.
OperStatus
Jenis: IF_OPER_STATUS
Status operasional untuk antarmuka seperti yang didefinisikan dalam RFC 2863 sebagai IfOperStatus. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2863.txt. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi IF_OPER_STATUS yang ditentukan dalam file header Ifdef.h .
AdminStatus
Jenis: NET_IF_ADMIN_STATUS
Status administratif untuk antarmuka seperti yang didefinisikan dalam RFC 2863. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2863.txt. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NET_IF_ADMIN_STATUS yang ditentukan dalam file header Ifdef.h .
MediaConnectState
Jenis: NET_IF_MEDIA_CONNECT_STATE
Status koneksi antarmuka. Anggota ini bisa menjadi salah satu nilai dari jenis enumerasi NET_IF_MEDIA_CONNECT_STATE yang ditentukan dalam file header Ifdef.h .
NetworkGuid
Jenis: NET_IF_NETWORK_GUID
GUID yang terkait dengan jaringan tempat antarmuka berada.
ConnectionType
Jenis: NET_IF_CONNECTION_TYPE
Jenis koneksi antarmuka jaringan NDIS. Anggota ini bisa menjadi salah satu nilai dari jenis enumerasi NET_IF_CONNECTION_TYPE yang ditentukan dalam file header Ifdef.h .
TransmitLinkSpeed
Jenis: ULONG64
Kecepatan dalam bit per detik dari tautan pengiriman.
ReceiveLinkSpeed
Jenis: ULONG64
Kecepatan dalam bit per detik dari tautan terima.
InOctets
Jenis: ULONG64
Jumlah oktet data yang diterima tanpa kesalahan melalui antarmuka ini. Nilai ini mencakup oktet dalam paket unicast, siaran, dan multicast.
InUcastPkts
Jenis: ULONG64
Jumlah paket unicast yang diterima tanpa kesalahan melalui antarmuka ini.
InNUcastPkts
Jenis: ULONG64
Jumlah paket non-unicast yang diterima tanpa kesalahan melalui antarmuka ini. Nilai ini mencakup paket siaran dan multicast.
InDiscards
Jenis: ULONG64
Jumlah paket masuk yang dipilih untuk dibuang meskipun tidak ada kesalahan yang terdeteksi untuk mencegah paket dikirimkan ke protokol lapisan yang lebih tinggi.
InErrors
Jenis: ULONG64
Jumlah paket masuk yang dibuang karena kesalahan.
InUnknownProtos
Jenis: ULONG64
Jumlah paket masuk yang dibuang karena protokol tidak diketahui.
InUcastOctets
Jenis: ULONG64
Jumlah oktet data yang diterima tanpa kesalahan dalam paket unicast melalui antarmuka ini.
InMulticastOctets
Jenis: ULONG64
Jumlah oktet data yang diterima tanpa kesalahan dalam paket multicast melalui antarmuka ini.
InBroadcastOctets
Jenis: ULONG64
Jumlah oktet data yang diterima tanpa kesalahan dalam paket siaran melalui antarmuka ini.
OutOctets
Jenis: ULONG64
Jumlah oktet data yang dikirimkan tanpa kesalahan melalui antarmuka ini. Nilai ini mencakup oktet dalam paket unicast, siaran, dan multicast.
OutUcastPkts
Jenis: ULONG64
Jumlah paket unicast yang dikirimkan tanpa kesalahan melalui antarmuka ini.
OutNUcastPkts
Jenis: ULONG64
Jumlah paket non-unicast yang dikirimkan tanpa kesalahan melalui antarmuka ini. Nilai ini mencakup paket siaran dan multicast.
OutDiscards
Jenis: ULONG64
Jumlah paket keluar yang dibuang meskipun tidak memiliki kesalahan.
OutErrors
Jenis: ULONG64
Jumlah paket keluar yang dibuang karena kesalahan.
OutUcastOctets
Jenis: ULONG64
Jumlah oktet data yang dikirimkan tanpa kesalahan dalam paket unicast melalui antarmuka ini.
OutMulticastOctets
Jenis: ULONG64
Jumlah oktet data yang dikirimkan tanpa kesalahan dalam paket multicast melalui antarmuka ini.
OutBroadcastOctets
Jenis: ULONG64
Jumlah oktet data yang dikirimkan tanpa kesalahan dalam paket siaran melalui antarmuka ini.
OutQLen
Jenis: ULONG64
Panjang antrean transmisi. Bidang ini saat ini tidak digunakan.
Keterangan
Struktur MIB_IF_ROW2 didefinisikan pada Windows Vista dan yang lebih baru.
Nilai untuk bidang Jenis ditentukan dalam file header Ipifcons.h . Hanya nilai yang mungkin tercantum dalam deskripsi anggota Jenis yang saat ini didukung.
Perhatikan bahwa file header Netioapi.h secara otomatis disertakan dalam file header Iphlpapi.h . File header Netioapi.h tidak boleh digunakan secara langsung.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Header | netioapi.h (termasuk Iphlpapi.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk