WLAN_NOTIFICATION_CALLBACK función de devolución de llamada (wlanapi.h)
El prototipo de función de devolución de llamada WLAN_NOTIFICATION_CALLBACK define el tipo de función de devolución de llamada de notificación.
Sintaxis
WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;
void WlanNotificationCallback(
PWLAN_NOTIFICATION_DATA unnamedParam1,
PVOID unnamedParam2
)
{...}
Parámetros
unnamedParam1
Puntero a una estructura de WLAN_NOTIFICATION_DATA que contiene la información de notificación.
Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Solo están disponibles las notificaciones de wlan_notification_acm_connection_complete y wlan_notification_acm_disconnected.
unnamedParam2
Puntero a la información de contexto proporcionada por el cliente cuando se registró para la notificación.
Valor devuelto
None
Observaciones
Una aplicación usa la función WlanRegisterNotification para registrar y anular el registro de notificaciones en todas las interfaces inalámbricas. Al registrarse para recibir notificaciones, una aplicación debe proporcionar una función de devolución de llamada a la que apunta el parámetro funcCallback pasado a la función WlanRegisterNotification . El prototipo de esta función de devolución de llamada es el WLAN_NOTIFICATION_CALLBACK. Esta función de devolución de llamada recibirá notificaciones registradas en el parámetro dwNotifSource pasado a la función WlanRegisterNotification .
Se llama a la función de devolución de llamada con un puntero a una estructura de WLAN_NOTIFICATION_DATA como primer parámetro que contiene información detallada sobre la notificación. La función de devolución de llamada también recibe un segundo parámetro que contiene un puntero al contexto de cliente pasado en el parámetro pCallbackContext a la función WlanRegisterNotification . Este contexto de cliente puede ser un puntero NULL si es lo que se pasó a la función WlanRegisterNotification .
Una vez registrada, se llamará a la función de devolución de llamada cada vez que haya una notificación disponible hasta que el cliente anule el registro o cierre el identificador.
Cualquier registro para recibir notificaciones se deshace automáticamente si la aplicación que realiza la llamada cierra su identificador de llamada (llamando a WlanCloseHandle con el parámetro hClientHandle ) usado para registrarse para recibir notificaciones con la función WlanRegisterNotification o si finaliza el proceso.
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada es WLAN_NOTIFICATION_SOURCE_ACM, la notificación recibida es una notificación del módulo de configuración automática. El miembro NotificationCode de la estructura WLAN_NOTIFICATION_DATA que se pasa a la función WLAN_NOTIFICATION_CALLBACK determina la interpretación del miembro pData de WLAN_NOTIFICATION_DATA estructura. Para obtener más información sobre estas notificaciones, consulte la referencia de enumeración WLAN_NOTIFICATION_ACM .
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada es WLAN_NOTIFICATION_SOURCE_HNWK, la notificación recibida es una notificación de red hospedada inalámbrica compatible con Windows 7 y en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado. El miembro NotificationCode de la estructura WLAN_NOTIFICATION_DATA que se pasa a la función WLAN_NOTIFICATION_CALLBACK determina la interpretación del miembro pData de WLAN_NOTIFICATION_DATA estructura. Para obtener más información sobre estas notificaciones, consulte la referencia de enumeración WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada es WLAN_NOTIFICATION_SOURCE_IHV, la notificación recibida es una notificación de proveedor de hardware (IHV) independiente. El miembro NotificationCode de la estructura de WLAN_NOTIFICATION_DATA que se pasa a la función WLAN_NOTIFICATION_CALLBACK determina la interpretación del miembro pData de WLAN_NOTIFICATION_DATA estructura, que es específica del IHV.
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada se WLAN_NOTIFICATION_SOURCE_ONEX, la notificación recibida es una notificación del módulo 802.1X. El miembro NotificationCode de la estructura WLAN_NOTIFICATION_DATA que se pasa a la función WLAN_NOTIFICATION_CALLBACK determina la interpretación del miembro pData de WLAN_NOTIFICATION_DATA estructura. Para obtener más información sobre estas notificaciones, consulte la referencia de enumeración ONEX_NOTIFICATION_TYPE .
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada es WLAN_NOTIFICATION_SOURCE_MSM, la notificación recibida es una notificación de módulo específico de medios (MSM). El miembro NotificationCode de la estructura WLAN_NOTIFICATION_DATA que se pasa a la función WLAN_NOTIFICATION_CALLBACK determina la interpretación del miembro pData de WLAN_NOTIFICATION_DATA estructura. Para obtener más información sobre estas notificaciones, consulte la referencia de enumeración WLAN_NOTIFICATION_MSM .
Si el miembro NotificationSource de la estructura de WLAN_NOTIFICATION_DATA recibido por la función de devolución de llamada es WLAN_NOTIFICATION_SOURCE_SECURITY, la notificación recibida es una notificación de seguridad. Actualmente no se han definido notificaciones para WLAN_NOTIFICATION_SOURCE_SECURITY.
Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: El servicio Netman controla las notificaciones. Si el servicio Netman está deshabilitado o no está disponible, no se recibirán notificaciones. Si no se recibe una notificación dentro de un período de tiempo razonable, una aplicación debe agotar el tiempo de espera y consultar el estado de la interfaz actual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wlanapi.h |
| Redistribuible | API LAN inalámbrica para Windows XP con SP2 |