Função CancelMibChangeNotify2
A função CancelMibChangeNotify2 desregista uma notificação de alteração de driver para alterações de 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áveis.
Sintaxe
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
Parâmetros
- NotificationHandle [in]
O identificador retornado de uma função de registro ou recuperação de notificação para indicar qual notificação cancelar.
Retornar valor
CancelMibChangeNotify2 retornará 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 for 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 desregula uma notificação de alteração de driver solicitada anteriormente para alterações de 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, NotifyRouteChange2 ou NotifyUnicastIpAddressChange. A função CancelMibChangeNotify2 também cancela uma solicitação anterior para recuperar a tabela de endereços IP unicast estáveis em um computador local. 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 desregistrar notificações de alteração de driver ou cancelar uma solicitação pendente para recuperar a tabela de endereços IP unicast estáveis.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
parâmetro |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |