Fungsi NhpAllocateAndGetInterfaceInfoFromStack (iphlpapi.h)

[Fungsi ini tidak lagi tersedia untuk digunakan pada Windows Vista. Sebagai gantinya, gunakan fungsi GetAdaptersAddresses dan struktur IP_ADAPTER_ADDRESSES terkait.]

Fungsi NhpAllocateAndGetInterfaceInfoFromStack mendapatkan informasi adaptor tentang komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD NhpAllocateAndGetInterfaceInfoFromStack(
  IP_INTERFACE_NAME_INFO **ppTable,
  PDWORD                 pdwCount,
  BOOL                   bOrder,
  HANDLE                 hHeap,
  DWORD                  dwFlags
);

Parameter

ppTable

Array struktur IP_INTERFACE_NAME_INFO yang berisi informasi tentang setiap adaptor pada sistem lokal. Array berisi satu elemen untuk setiap adaptor pada sistem.

pdwCount

Jumlah elemen dalam array ppTable .

bOrder

Ketika TRUE, elemen dalam array ppTable diurutkan dengan meningkatkan nilai indeks.

hHeap

Handel yang menentukan timbunan dari mana ppTable harus dialokasikan. Parameter ini dapat menjadi tumpukan proses yang dikembalikan oleh panggilan ke fungsi GetProcessHeap , atau tumpukan privat yang dibuat oleh panggilan ke fungsi HeapCreate .

dwFlags

Sekumpulan bendera yang akan diteruskan ke fungsi HeapAlloc saat mengalokasikan memori untuk ppTable. Lihat fungsi HeapAlloc untuk informasi selengkapnya.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan.

Keterangan

Dalam Kit Pengembangan Perangkat Lunak (SDK) Microsoft Windows, fungsi NhpAllocateAndGetInterfaceInfoFromStack ditentukan pada Windows 2000 dengan Paket Layanan 1 (SP1) dan yang lebih baru. Saat mengompilasi aplikasi, jika platform target adalah Windows 2000 dengan SP1 dan yang lebih baru (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500, atau WINVER >= 0x0500), NhpAllocateAndGetInterfaceInfoFromStack ditentukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	iphlpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll

Lihat juga

GetAdaptersAddresses

GetProcessHeap

HeapCreate

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IP_INTERFACE_NAME_INFO