Função GetIfEntry2

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

Importante

Para desenvolvedores de drivers, recomenda-se usar GetIfEntry2Ex com MibIfEntryNormalWithoutStatistics quando possível, a fim de evitar um impasse ao fazer a manutenção de OIDs NDIS.

Sintaxe

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

Parâmetros

Linha [entrada, saída]
Um ponteiro para uma estrutura de 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 InterfaceIndex membro da estrutura MIB_IF_ROW2 para a interface para recuperar informações.

Valor de retorno

GetIfEntry2 retornará 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. Este erro é retornado se um ponteiro de NULL é passado no parâmetro Row.
STATUS_NOT_FOUND	A interface especificada não pôde ser encontrada. Este erro é retornado se a função não consegue encontrar a interface de rede especificada pelo InterfaceLuid ou InterfaceIndex membro da estrutura de MIB_IF_ROW2 para a qual o parâmetro Row aponta.
Outros	Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

Na entrada, o driver deve inicializar pelo menos o InterfaceLuid ou membro do 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 de MIB_IF_ROW2 para os quais o parâmetro Row aponta são preenchidos.

Requerimentos

Plataforma de destino	Universal
Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Netioapi.h (inclui Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL