Função NhpAllocateAndGetInterfaceInfoFromStack (iphlpapi.h)

Artigo
02/28/2024

[Essa função não está mais disponível para uso a partir do Windows Vista. Em vez disso, use a função GetAdaptersAddresses e a estrutura IP_ADAPTER_ADDRESSES associada.]

A função NhpAllocateAndGetInterfaceInfoFromStack obtém informações do adaptador sobre o computador local.

Sintaxe

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

Parâmetros

ppTable

Uma matriz de estruturas de IP_INTERFACE_NAME_INFO que contém informações sobre cada adaptador no sistema local. A matriz contém um elemento para cada adaptador no sistema.

pdwCount

O número de elementos na matriz ppTable .

bOrder

Quando TRUE, os elementos na matriz ppTable são classificados aumentando o valor do índice.

hHeap

Um identificador que especifica o heap do qual ppTable deve ser alocado. Esse parâmetro pode ser o heap de processo retornado por uma chamada para a função GetProcessHeap ou um heap privado criado por uma chamada para a função HeapCreate .

dwFlags

Um conjunto de sinalizadores a serem passados para a função HeapAlloc ao alocar memória para ppTable. Consulte a função HeapAlloc para obter mais informações.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida.

Comentários

No Microsoft Software Development Kit do Windows (SDK do Windows) (SDK), a função NhpAllocateAndGetInterfaceInfoFromStack é definida no Windows 2000 com Service Pack 1 (SP1) e posterior. Ao compilar um aplicativo, se a plataforma de destino for o Windows 2000 com SP1 e posterior (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500ou WINVER >= 0x0500), o NhpAllocateAndGetInterfaceInfoFromStack será definido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003, Windows 2000 Server com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	iphlpapi.h
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll