Fungsi GetAdapterIndex (iphlpapi.h)

Fungsi GetAdapterIndex mendapatkan indeks adaptor, mengingat namanya.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD GetAdapterIndex(
  [in]      LPWSTR AdapterName,
  [in, out] PULONG IfIndex
);

Parameter

[in] AdapterName

Penunjuk ke string Unicode yang menentukan nama adaptor.

[in, out] IfIndex

Penunjuk ke variabel ULONG yang menunjuk ke indeks adaptor.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Hingga adaptor sepenuhnya dinonaktifkan, fungsi GetAdapterIndex melaporkan adaptor seperti yang ada. Misalnya, fungsi NotifyAddrChange dapat menunjukkan alamat IP adaptor yang baru dinonaktifkan dihapus, tetapi GetAdapterIndex terus melaporkan indeks adaptor hingga proses penonaktifan adaptor selesai.

Ketika satu atau beberapa adaptor ada pada sistem, GetAdapterIndex mengembalikan ERROR_DEV_NOT_EXIST ketika adaptor yang dikueri tidak ada. Ketika tidak ada adaptor, fungsi GetAdapterIndex mengembalikan ERROR_NO_DATA.

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

Persyaratan

Lihat juga

GetAdaptersInfo

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IP_ADAPTER_INFO

MprConfigGetFriendlyName

MprConfigGetGuidName

NotifyAddrChange