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.

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

Confira também

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange

NotifyUnicastIpAddressChange