Função CancelMibChangeNotify2 (netioapi.h)

Artigo
03/15/2023

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