Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A função CreateAnycastIpAddressEntry adiciona uma nova entrada de endereço IP anycast em um computador local.
Sintaxe
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parâmetros
-
linha [in]
Um ponteiro para uma entrada de estrutura MIB_ANYCASTIPADDRESS_ROW para uma entrada de endereço IP anycast.
Valor de retorno
CreateAnycastIpAddressEntry retornará STATUS_SUCCESS se a função for bem-sucedida.
Se a função falhar, CreateAnycastIpAddressEntry 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, o Endereço membro da estrutura MIB_ANYCASTIPADDRESS_ROW à qual o parâmetro de Linha aponta não foi definido como um endereço IPv4 ou IPv6 unicast válido ou ambos InterfaceLuid e membros InterfaceIndex da estrutura MIB_ANYCASTIPADDRESS_ROW 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 o adaptador de rede especificado pelo InterfaceLuid ou interfaceIndex membro da estrutura MIB_UNICASTIPADDRESS_ROW à qual o parâmetro Row 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_ANYCASTIPADDRESS_ROW à 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 Address membro. |
| ERROR_OBJECT_ALREADY_EXISTS | O objeto já existe. Esse erro será retornado se o Address membro da estrutura MIB_ANYCASTIPADDRESS_ROW à qual o parâmetro Linha aponta for uma duplicata de um endereço IP anycast existente na interface especificada pelo interfaceLuid ou membro interfaceIndex da estrutura MIB_ANYCASTIPADDRESS_ROW. |
| Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Observações
O driver deve inicializar os seguintes membros da estrutura MIB_ANYCASTIPADDRESS_ROW à qual o parâmetro Linha aponta.
endereço
Defina como um endereço IPv4 ou IPv6 unicast válido e uma 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 à qual adicionar o endereço IP unicast. 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.
O membro ScopeId da estrutura MIB_ANYCASTIPADDRESS_ROW à qual o parâmetro Linha aponta é ignorado quando a função CreateAnycastIpAddressEntry é chamada. O membro ScopeId é determinado automaticamente pela interface na qual o endereço é adicionado.
A função CreateAnycastIpAddressEntry falhará se o endereço IP anycast que é passado no Address membro da estrutura MIB_ANYCASTIPADDRESS_ROW à qual o parâmetro Row aponta ser uma duplicata de um endereço IP anycast existente na interface.
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 |