Função CreateIpNetEntry2

A função CreateIpNetEntry2 cria uma nova entrada de endereço IP vizinho no computador local.

Sintaxe

NETIOAPI_API CreateIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Parâmetros

Linha [in]
Um ponteiro para uma entrada de estrutura MIB_IPNET_ROW2 para uma entrada de rota IP.

Valor de retorno

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

Se a função falhar, CreateIpNetEntry2 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 ocorrer um dos seguintes itens: Um ponteiro de NULL é passado no parâmetro Row. O endereço membro da estrutura de MIB_IPNET_ROW2 para a qual o parâmetro de linha aponta não foi definido como um endereço IPv4 ou IPv6 unicast, anycast ou multicast válido. O PhysicalAddress e PhysicalAddressLength membros da estrutura MIB_IPNET_ROW2 não foram definidos como um endereço físico válido. Tanto InterfaceLuid quanto InterfaceIndex membros da estrutura MIB_IPNET_ROW2 não foram especificados. Um endereço de loopback foi passado no Address membro.
STATUS_NOT_FOUND	A interface especificada não pôde ser encontrada. Este erro é retornado se a função não conseguir encontrar a interface de rede especificada pelo InterfaceLuid ou InterfaceIndex membro da estrutura de MIB_IPNET_ROW2 para a qual o parâmetro Row aponta.
STATUS_NOT_SUPPORTED	A solicitação não é suportada. Este erro é 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 que a linha pontos de parâmetro, ou se nenhuma pilha IPv6 estiver localizada no computador local e um endereço IPv6 tiver sido especificado no membro Endereço.
ERROR_OBJECT_ALREADY_EXISTS	O objeto já existe. Este erro é retornado se o endereço membro da estrutura de MIB_IPNET_ROW2 para a qual o parâmetro Row aponta for uma duplicata de um endereço IP vizinho existente na interface especificada pelo InterfaceLuid ou InterfaceIndex membro da estrutura MIB_IPNET_ROW2.
Outros	Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

O driver deve inicializar os seguintes membros da estrutura de MIB_IPNET_ROW2 para a qual o parâmetro Row aponta:

Defina o endereço membro como um endereço e família IPv4 ou IPv6 unicast, anycast ou multicast válidos.
Defina o PhysicalAddress e membros do PhysicalAddressLength na estrutura MIB_IPNET_ROW2 para um endereço físico válido.
Defina InterfaceLuid ou InterfaceIndex para o valor LUID ou índice da interface.

Os membros InterfaceLuid e InterfaceIndex são usados na ordem listada anteriormente. Portanto, se o InterfaceLuid for especificado, esse membro será usado para determinar a interface na qual adicionar o endereço IP unicast. 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.

A função CreateIpNetEntry2 falhará se o endereço IP que é passado no endereço membro da estrutura de MIB_IPNET_ROW2 para a qual o parâmetro Row aponta for uma duplicata de um endereço IP vizinho existente na interface.

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