Partilhar via


Função CancelMibChangeNotify2

A função CancelMibChangeNotify2 cancela o registro de uma notificação de alteração de driver para alterações na interface IP, alterações de endereço IP, alterações de rota IP e solicitações para recuperar a tabela de endereços IP Unicast estável.

Sintaxe

NETIOAPI_API CancelMibChangeNotify2(
  _In_ HANDLE NotificationHandle
);

Parâmetros

  • NotificationHandle [em]
    O identificador que é retornado de um registro de notificação ou função de recuperação para indicar qual notificação cancelar.

Valor de retorno

CancelMibChangeNotify2 retorna STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, CancelMibChangeNotify2 retornará um dos seguintes códigos de erro:

Código de retorno Descrição
STATUS_INVALID_PARAMETER

Um parâmetro inválido foi passado para a função. CancelMibChangeNotify2 retornará esse erro se o parâmetro NotificationHandle foi um ponteiro NULL.

Outros

Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função CancelMibChangeNotify2 cancela o registro de uma notificação de alteração de driver solicitada anteriormente para alterações na interface IP, alterações de endereço IP ou alterações de rota IP em um computador local. Essas solicitações são feitas chamando NotifyIpInterfaceChange, NotifyRouteChange2ou NotifyUnicastIpAddressChange. A função CancelMibChangeNotify2 também cancela uma solicitação anterior para recuperar a tabela de endereços IP unicast estável em um computador local. Essa solicitação é feita chamando a funçãoNotifyStableUnicastIpAddressTable.

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

Requerimentos

Plataforma de destino

Universal

Versão

Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.

Cabeçalho

Netioapi.h (inclui Netioapi.h)

Biblioteca

Netio.lib

IRQL

PASSIVE_LEVEL

Ver também

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyUnicastIpAddressChange