Função SetIpNetEntry2

Artigo
03/08/2023

A função SetIpNetEntry2 define o endereço físico de uma entrada de endereço IP vizinho existente em um computador local.

Sintaxe

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parâmetros

Linha [in]
Um ponteiro para uma entrada de estrutura MIB_IPNET_ROW2 para uma entrada de endereço IP vizinho.

Retornar valor

SetIpNetEntry2 retornará STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, SetIpNetEntry2 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 é retornado nas situações a seguir. Um ponteiro NULL foi passado no parâmetro Row . O membro Address da estrutura MIB_IPNET_ROW2 para a qual o parâmetro Row aponta não foi definido como um endereço IPv4 ou IPv6 unicast, anycast ou multicast válido. Os membros PhysicalAddress e PhysicalAddressLength da estrutura MIB_IPNET_ROW2 não foram definidos como um endereço físico válido. Os membros InterfaceLuid e InterfaceIndex da estrutura MIB_IPNET_ROW2 não foram especificados. Um endereço de loopback foi passado no membro Address .
STATUS_NOT_FOUND	Não foi possível encontrar a interface especificada. Esse erro será retornado se a função não puder localizar o adaptador de rede especificado pelo membro InterfaceLuid ou InterfaceIndex da estrutura MIB_IPNET_ROW2 para a qual o parâmetro Row aponta.
STATUS_NOT_SUPPORTED	A solicitação não terá suporte. Esse erro será retornado se nenhuma pilha IPv4 estiver localizada no computador local e um endereço IPv4 tiver sido especificado no membro Address da estrutura MIB_IPNET_ROW2 para a 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.

Comentários

O driver deve inicializar os membros a seguir da estrutura MIB_IPNET_ROW2 para a qual o parâmetro Row aponta.

Endereço
Defina como um endereço e uma família IPv4 ou IPv6 válidos, anycast ou multicast.
PhysicalAddress e PhysicalAddressLength
Defina como um endereço físico válido.
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.

A função SetIpNetEntry2 falhará se o endereço IP passado no membro Address da estrutura MIB_IPNET_ROW2 para a qual o parâmetro Row aponta não for um endereço IP vizinho existente na interface especificada.

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