Функция NhpAllocateAndGetInterfaceInfoFromStack (iphlpapi.h)

Статья
02/28/2024

[Эта функция больше не доступна для использования в Windows Vista. Вместо этого используйте функцию GetAdaptersAddresses и связанную структуру IP_ADAPTER_ADDRESSES .]

Функция NhpAllocateAndGetInterfaceInfoFromStack получает сведения об адаптере локального компьютера.

Синтаксис

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

Параметры

ppTable

Массив структур IP_INTERFACE_NAME_INFO , содержащий сведения о каждом адаптере в локальной системе. Массив содержит по одному элементу для каждого адаптера в системе.

pdwCount

Количество элементов в массиве ppTable .

bOrder

При значении TRUE элементы в массиве ppTable сортируются путем увеличения значения индекса.

hHeap

Дескриптор, указывающий кучу, из которой следует выделить ppTable . Этот параметр может быть кучей процесса, возвращенной вызовом функции GetProcessHeap , или частной кучей, созданной вызовом функции HeapCreate .

dwFlags

Набор флагов, передаваемых функции HeapAlloc при выделении памяти для ppTable. Дополнительные сведения см. в разделе Функция HeapAlloc .

Возвращаемое значение

Возвращает ERROR_SUCCESS после успешного завершения.

В Microsoft пакет средств разработки программного обеспечения для Windows (SDK) функция NhpAllocateAndGetInterfaceInfoFromStack определена в Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий. При компиляции приложения, если целевой платформой является Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500или WINVER >= 0x0500), определяется nhpAllocateAndGetInterfaceInfoFromStack .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера	Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	iphlpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll