Função GetIfEntry2
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 |