Eventos
19 de nov., 23 - 21 de nov., 23
Obtenha a vantagem competitiva de que você precisa com poderosas soluções de IA e nuvem participando do Microsoft Ignite online.
Registrar agoraNão há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
A função DeleteUnicastIpAddressEntry exclui uma entrada de endereço IP unicast existente no computador local.
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API DeleteUnicastIpAddressEntry(
[in] const MIB_UNICASTIPADDRESS_ROW *Row
);
[in] Row
Um ponteiro para uma entrada de estrutura MIB_UNICASTIPADDRESS_ROW para uma entrada de endereço IP unicast existente a ser excluída do computador local.
Se a função for bem-sucedida, o valor retornado será NO_ERROR.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
Código de retorno | Descrição |
---|---|
|
Acesso negado. Esse erro é retornado sob várias condições que incluem o seguinte: o usuário não tem os privilégios administrativos necessários no computador local ou o aplicativo não está em execução em um shell aprimorado como administrador interno (administrador de RunAs). |
|
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 membro Address do MIB_UNICASTIPADDRESS_ROW apontado pelo parâmetro Row não tiver sido definido como um endereço IPv4 ou IPv6 unicast válido ou os membros InterfaceLuid ou InterfaceIndex do MIB_UNICASTIPADDRESS_ROW apontados pelo parâmetro Row não foram especificados. |
|
Não foi possível encontrar a interface especificada. Esse erro será retornado se o adaptador de rede especificado pelo membro InterfaceLuid ou InterfaceIndex do MIB_UNICASTIPADDRESS_ROW apontado pelo parâmetro Row não puder ser encontrado. |
|
A solicitação não terá suporte. Esse erro será retornado se nenhuma pilha IPv4 estiver no computador local e um endereço IPv4 tiver sido especificado no membro addressMIB_UNICASTIPADDRESS_ROW apontado pelo parâmetro Row . Esse erro também será retornado se nenhuma pilha IPv6 estiver no computador local e um endereço IPv6 tiver sido especificado no membro Address . |
|
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
A função DeleteUnicastIpAddressEntry é definida no Windows Vista e posterior.
A função DeleteUnicastIpAddressEntry é usada para excluir uma entrada de estrutura MIB_UNICASTIPADDRESS_ROW existente no computador local.
Na entrada, o membro Address na estrutura de MIB_UNICASTIPADDRESS_ROW apontada pelo parâmetro Row deve ser definido como um endereço IPv4 ou IPv6 válido e família. Além disso, pelo menos um dos seguintes membros na estrutura MIB_UNICASTIPADDRESS_ROW apontado para o parâmetro Row deve ser inicializado: InterfaceLuid ou InterfaceIndex.
Os campos são usados na ordem listada acima. Portanto, se o InterfaceLuid for especificado, esse membro será usado para determinar a interface. Se nenhum valor tiver sido definido para o membro InterfaceLuid (os valores desse membro foram definidos como zero), o membro InterfaceIndex será usado em seguida para determinar a interface.
Se a função for bem-sucedida, o endereço IP existente representado pelo parâmetro Row será excluído.
A função GetUnicastIpAddressTable pode ser chamada para enumerar as entradas de endereço IP unicast em um computador local. A função GetUnicastIpAddressEntry pode ser chamada para recuperar uma entrada de endereço IP unicast existente específica.
A função DeleteUnicastIpAddressEntry só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se DeleteUnicastIpAddressEntry for chamado por um usuário que não é membro do grupo Administradores, a chamada de função falhará e ERROR_ACCESS_DENIED será retornado. Essa função também pode falhar devido ao UAC (controle de conta de usuário) no Windows Vista e posterior. Se um aplicativo que contém essa função for executado por um usuário conectado como membro do grupo Administradores diferente do Administrador interno, essa chamada falhará, a menos que o aplicativo tenha sido marcado no arquivo de manifesto com um requestedExecutionLevel definido para exigirAdministrator. Se o aplicativo não tiver esse arquivo de manifesto, um usuário conectado como membro do grupo Administradores diferente do Administrador interno deverá executar o aplicativo em um shell aprimorado como administrador interno (administrador RunAs) para que essa função tenha êxito.
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | netioapi.h (inclua Iphlpapi.h) |
Biblioteca | Iphlpapi.lib |
DLL | Iphlpapi.dll |
Referência de função auxiliar de IP
Eventos
19 de nov., 23 - 21 de nov., 23
Obtenha a vantagem competitiva de que você precisa com poderosas soluções de IA e nuvem participando do Microsoft Ignite online.
Registrar agora