Função GetIpNetEntry2
A função GetIpNetEntry2 recupera informações para uma entrada de endereço IP vizinho no computador local.
Sintaxe
NETIOAPI_API GetIpNetEntry2(
_Inout_ PMIB_IPNET_ROW2 Row
);
Parâmetros
-
linha [dentro, fora]
Um ponteiro para uma entrada de estrutura MIB_IPNET_ROW2 para uma entrada de endereço IP vizinho. No retorno bem-sucedido, essa estrutura é atualizada com as propriedades do endereço IP vizinho.
Valor de retorno
GetIpNetEntry2 retornará STATUS_SUCCESS se a função for bem-sucedida.
Se a função falhar, GetIpNetEntry2 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 de NULL for passado no parâmetro linha, o address membro da estrutura MIB_IPNET_ROW2 à qual o parâmetro de Linha aponta não foi definido como um endereço IPv4 ou IPv6 de vizinho válido, ou ambos InterfaceLuid e membros interfaceIndex da estrutura MIB_IPNET_ROW2 não foram especificados. |
| STATUS_NOT_FOUND | Não foi possível encontrar a interface especificada. Esse erro será retornado se a função não puder encontrar a interface de rede especificada pelo InterfaceLuid ou membro interfaceIndex da estrutura MIB_IPNET_ROW2 à qual o parâmetro linha aponta. |
| STATUS_NOT_SUPPORTED | Não há suporte para a solicitação. Esse erro será retornado se nenhuma pilha IPv4 estiver localizada no computador local e um endereço IPv4 tiver sido especificado no Address membro da estrutura MIB_IPNET_ROW2 à qual o parâmetro Row aponta ou se nenhuma pilha IPv6 estiver localizada no computador local e um endereço IPv6 tiver sido especificado no membro Address. |
| Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Observações
A função GetIpNetEntry2 é usada para recuperar uma entrada de estrutura MIB_IPNET_ROW2.
Na entrada, o driver deve inicializar os seguintes membros da estrutura MIB_IPNET_ROW2 à qual o parâmetro Row aponta.
endereço
Defina como um endereço IPv4 ou IPv6 de vizinho válido ou família.InterfaceLuid ou interfaceIndex
Esses 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, quando a chamada for bem-sucedida, GetIpNetEntry2 recuperará as outras propriedades para o endereço IP vizinho e preencherá a estrutura de MIB_IPNET_ROW2 à qual o parâmetro Row aponta.
O driver pode chamar a função GetIpNetTable2 para enumerar as entradas de endereço IP vizinhas em um computador local.
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 |