Fungsi GetPerAdapterInfo (iphlpapi.h)

Artikel
03/04/2024

Fungsi GetPerAdapterInfo mengambil informasi tentang adaptor yang sesuai dengan antarmuka yang ditentukan.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

Parameter

[in] IfIndex

Indeks antarmuka. Fungsi GetPerAdapterInfo mengambil informasi untuk adaptor yang sesuai dengan antarmuka ini.

[out] pPerAdapterInfo

Penunjuk ke struktur IP_PER_ADAPTER_INFO yang menerima informasi tentang adaptor.

[in] pOutBufLen

Penunjuk ke variabel ULONG yang menentukan ukuran struktur IP_PER_ADAPTER_INFO . Jika ukuran ini tidak cukup untuk menyimpan informasi, GetPerAdapterInfo mengisi variabel ini dengan ukuran yang diperlukan, dan mengembalikan kode kesalahan ERROR_BUFFER_OVERFLOW.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_BUFFER_OVERFLOW	Ukuran buffer yang ditunjukkan oleh parameter pOutBufLen terlalu kecil untuk menyimpan informasi adaptor. Parameter pOutBufLen menunjuk ke ukuran yang diperlukan.
ERROR_INVALID_PARAMETER	Parameter pOutBufLen adalah NULL, atau proses panggilan tidak memiliki akses baca/tulis ke memori yang ditujukan oleh pOutBufLen, atau proses panggilan tidak memiliki akses tulis ke memori yang diacu oleh parameter pAdapterInfo .
ERROR_NOT_SUPPORTED	GetPerAdapterInfo tidak didukung oleh sistem operasi yang berjalan di komputer lokal.
Lainnya	Jika fungsi gagal, gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Indeks adaptor dapat berubah ketika adaptor dinonaktifkan lalu diaktifkan, atau dalam keadaan lain, dan tidak boleh dianggap persisten.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	iphlpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll

Lihat juga

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IP_PER_ADAPTER_INFO

Bagikan melalui