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 |
|---|---|
|
Um parâmetro inválido foi passado para a função. Esse erro será retornado se o parâmetro NotificationHandle for um ponteiro NULL . |
|
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 |