Función NotifyNetworkConnectivityHintChange (netioapi.h)

Registra una función de devolución de llamada definida por la aplicación, a la que se llamará cuando cambie el nivel de conectividad de red agregado y las sugerencias de costo.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyNetworkConnectivityHintChange(
  [in]  PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK Callback,
  [in]  PVOID                                      CallerContext,
  [in]  BOOLEAN                                    InitialNotification,
  [out] PHANDLE                                    NotificationHandle
);

Parámetros

[in] Callback

Puntero de función de tipo PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, que apunta a la función de devolución de llamada definida por la aplicación. La función de devolución de llamada se invocará cuando se produzca un cambio de costo o nivel de conectividad de red.

[in] CallerContext

Contexto del autor de la llamada específico del usuario. Este contexto se proporcionará a la función de devolución de llamada.

[in] InitialNotification

True es si se debe proporcionar una notificación de inicialización; de lo contrario false, es .

[out] NotificationHandle

Puntero a un IDENTIFICADOR. La función establece el valor en un identificador para el registro de notificaciones.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. De lo contrario, se devuelve un código de error.

Comentarios

Para anular el registro de las notificaciones de cambios, llame a la función CancelMibChangeNotify2 y pase el parámetro NotificationHandle devuelto por NotifyNetworkConnectivityHintChange.

Requisitos

Consulte también

• PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK

• CancelMibChangeNotify2