Função GetIfEntry2
A função GetIfEntry2 recupera informações para a interface especificada em um computador local.
Importante
Para desenvolvedores de driver, é recomendável usar GetIfEntry2Ex com MibIfEntryNormalWithoutStatistics quando possível, a fim de evitar um deadlock ao atender os OIDs do NDIS.
Sintaxe
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parâmetros
-
linha [dentro, fora]
Um ponteiro para uma estrutura de MIB_IF_ROW2 que, no retorno bem-sucedido, recebe informações de 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 a qual 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. Esse erro será retornado se um ponteiro NULL for passado no parâmetro linha. |
| STATUS_NOT_FOUND | Não foi possível encontrar a interface especificada. Esse erro será retornado se a função não puder encontrar o adaptador de rede especificado pelo InterfaceLuid ou membro interfaceIndex da estrutura MIB_IF_ROW2 à qual o parâmetro Linha aponta. |
| Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Observações
Na entrada, o driver deve inicializar pelo menos o InterfaceLuid ou membro 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 tiver sido 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 à qual o parâmetro Linha são preenchidos.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |