Compartilhar via


Função GetPerAdapterInfo (iphlpapi.h)

A função GetPerAdapterInfo recupera informações sobre o adaptador correspondente à interface especificada.

Sintaxe

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

Parâmetros

[in] IfIndex

Índice de uma interface. A função GetPerAdapterInfo recupera informações para o adaptador correspondente a essa interface.

[out] pPerAdapterInfo

Ponteiro para uma estrutura IP_PER_ADAPTER_INFO que recebe informações sobre o adaptador.

[in] pOutBufLen

Ponteiro para uma variável ULONG que especifica o tamanho da estrutura IP_PER_ADAPTER_INFO . Se esse tamanho for insuficiente para manter as informações, GetPerAdapterInfo preencherá essa variável com o tamanho necessário e retornará um código de erro de ERROR_BUFFER_OVERFLOW.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_BUFFER_OVERFLOW
O tamanho do buffer indicado pelo parâmetro pOutBufLen é muito pequeno para conter as informações do adaptador. O parâmetro pOutBufLen aponta para o tamanho necessário.
ERROR_INVALID_PARAMETER
O parâmetro pOutBufLen é NULL ou o processo de chamada não tem acesso de leitura/gravação à memória apontada por pOutBufLen ou o processo de chamada não tem acesso de gravação à memória apontada pelo parâmetro pAdapterInfo .
ERROR_NOT_SUPPORTED

O GetPerAdapterInfo não tem suporte do sistema operacional em execução no computador local.

Outros
Se a função falhar, use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.
 
 

Comentários

Um índice de adaptador pode ser alterado quando o adaptador está desabilitado e habilitado ou em outras circunstâncias, e não deve ser considerado persistente.

Requisitos

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

Confira também

Referência de função auxiliar de IP

Página Inicial do Auxiliar de IP

IP_PER_ADAPTER_INFO