Función CancelMibChangeNotify2 (netioapi.h)
La función CancelMibChangeNotify2 registra las notificaciones de cambios para los cambios de la interfaz IP, los cambios de dirección IP, los cambios de ruta IP, los cambios de puerto teredo y cuando la tabla de direcciones IP de unidifusión es estable y se puede recuperar.
Sintaxis
IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
[in] HANDLE NotificationHandle
);
Parámetros
[in] NotificationHandle
Identificador devuelto de una función de registro o recuperación de notificaciones para indicar qué notificación se va a cancelar.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Se pasó un parámetro no válido a la función. Este error se devuelve si el parámetro NotificationHandle era un puntero NULL . |
|
Use FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Comentarios
La función CancelMibChangeNotify2 se define en Windows Vista y versiones posteriores.
The
CancelMibChangeNotify2 registra una notificación de cambio solicitada previamente para los cambios de la interfaz IP, los cambios de dirección IP, los cambios de ruta IP o los cambios de puerto teredo en un equipo local. Estas solicitudes se realizan llamando a NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 o NotifyTeredoPortChange. The
La función CancelMibChangeNotify2 también cancela una solicitud anterior para recibir una notificación cuando la tabla de direcciones IP de unidifusión es estable en un equipo local y se puede recuperar. Esta solicitud se realiza llamando a la función NotifyStableUnicastIpAddressTable .
El parámetro NotificationHandle devuelto a estas funciones de notificación se pasa a CancelMibChangeNotify2 para anular el registro de las notificaciones o cancelar una solicitud pendiente para recuperar la tabla de direcciones IP de unidifusión estable.
Una aplicación no puede realizar una llamada a la función CancelMibChangeNotify2 desde el contexto del subproceso que está ejecutando actualmente la función de devolución de llamada de notificación para el mismo parámetro NotificationHandle . De lo contrario, el subproceso que ejecuta esa devolución de llamada dará como resultado un interbloqueo. Por lo tanto, la función CancelMibChangeNotify2 no debe llamarse directamente como parte de la rutina de devolución de llamada de notificación. En una situación más general, un subproceso que ejecuta la función CancelMibChangeNotify2 no puede poseer un recurso en el que el subproceso que ejecuta una operación de devolución de llamada de notificación esperaría porque daría lugar a un interbloqueo similar. Se debe llamar a la función CancelMibChangeNotify2 desde un subproceso diferente, en el que el subproceso que recibe la devolución de llamada de notificación no tiene dependencias.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | netioapi.h (include Iphlpapi.h) |
| Library | Iphlpapi.lib |
| Archivo DLL | Iphlpapi.dll |