Compartilhar via

Função GetIfEntry2

  • Artigo

A função GetIfEntry2 recupera informações para a interface especificada em um computador local.

Importante

Para desenvolvedores de drivers, é recomendável usar GetIfEntry2Ex com MibIfEntryNormalWithoutStatistics quando possível, a fim de evitar um impasse ao atender OIDs NDIS.

Sintaxe

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

Parâmetros

  • Linha [entrada, saída]
    Um ponteiro para uma estrutura MIB_IF_ROW2 que, no retorno bem-sucedido, recebe informações para uma interface no computador local. Na entrada, o driver deve definir o membro InterfaceLuid ou o membro InterfaceIndex da estrutura MIB_IF_ROW2 para a interface para recuperar informações.

Valor retornado

GetIfEntry2 retorna STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, GetIfEntry2 retornará um dos seguintes códigos de erro:

Código de retorno Descrição
STATUS_INVALID_PARAMETER

Um parâmetro inválido foi passado para a função. Esse erro será retornado se um ponteiro NULL for passado no parâmetro Row .
STATUS_NOT_FOUND

Não foi possível encontrar a interface especificado. Esse erro será retornado se a função não puder localizar a interface de rede especificada pelo membro InterfaceLuid ou InterfaceIndex da estrutura MIB_IF_ROW2 para a qual o parâmetro Row aponta.
Outras

Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

Na entrada, seu driver deve inicializar pelo menos o membro InterfaceLuid ou InterfaceIndex na estrutura MIB_IF_ROW2 que é passada no parâmetro Row. Os membros são usados na ordem listada anteriormente. Portanto, se InterfaceLuid for especificado, esse membro será usado para determinar a interface. Se nenhum valor foi definido para o membro InterfaceLuid (o valor desse membro foi definido como zero), o membro InterfaceIndex será usado em seguida para determinar a interface.

Na saída, os campos restantes da estrutura MIB_IF_ROW2 para a qual o parâmetro Row aponta são preenchidos.

Requisitos

Plataforma de destino

 Universal

Versão

Disponível no Windows Vista e em versões posteriores dos sistemas operacionais Windows.

Cabeçalho

 Netioapi.h (incluir Netioapi.h)

Biblioteca

 Netio.lib

IRQL

< DISPATCH_LEVEL

Confira também

GetIfTable2

GetIfTable2Ex

MIB_IF_ROW2

MIB_IF_TABLE2