Compartilhar via


Função CancelMibChangeNotify2 (netioapi.h)

Os desregistros de função CancelMibChangeNotify2 para notificações de alteração para alterações de interface IP, alterações de endereço IP, alterações de rota IP, alterações na porta teredo e quando a tabela de endereços IP unicast é estável e pode ser recuperada.

Sintaxe

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

Parâmetros

[in] NotificationHandle

O identificador retornado de uma função de registro ou recuperação de notificação para indicar qual notificação cancelar.

Retornar valor

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
ERROR_INVALID_PARAMETER
Um parâmetro inválido foi passado para a função. Esse erro será retornado se o parâmetro NotificationHandle for um ponteiro NULL .
Outros
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função CancelMibChangeNotify2 é definida no Windows Vista e posterior.

O
CancelMibChangeNotify2 function deregisters for a change notification previously requested for IP interface changes, IP address changes, IP route changes, or Teredo port changes on a local computer. Essas solicitações são feitas chamando NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 ou NotifyTeredoPortChange. O
A função CancelMibChangeNotify2 também cancela uma solicitação anterior para ser notificada quando a tabela de endereços IP unicast está estável em um computador local e pode ser recuperada. Essa solicitação é feita chamando a função NotifyStableUnicastIpAddressTable .

O parâmetro NotificationHandle retornado a essas funções de notificação é passado para CancelMibChangeNotify2 para cancelar o registro de notificações ou cancelar uma solicitação pendente para recuperar a tabela de endereços IP unicast estáveis.

Um aplicativo não pode fazer uma chamada para a função CancelMibChangeNotify2 do contexto do thread que está executando atualmente a função de retorno de chamada de notificação para o mesmo parâmetro NotificationHandle . Caso contrário, o thread que executa esse retorno de chamada resultará em deadlock. Portanto, a função CancelMibChangeNotify2 não deve ser chamada diretamente como parte da rotina de retorno de chamada de notificação. Em uma situação mais geral, um thread que executa a função CancelMibChangeNotify2 não pode ter um recurso no qual o thread que executa uma operação de retorno de chamada de notificação aguardaria porque resultaria em um deadlock semelhante. A função CancelMibChangeNotify2 deve ser chamada de um thread diferente, no qual o thread que recebe o retorno de chamada de notificação não tem dependências.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho netioapi.h (inclua Iphlpapi.h)
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange

NotifyUnicastIpAddressChange