estructura WLAN_CONNECTION_NOTIFICATION_DATA (wlanapi.h)
La estructura WLAN_CONNECTION_NOTIFICATION_DATA contiene información sobre las notificaciones relacionadas con la conexión.
Sintaxis
typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
BOOL bSecurityEnabled;
WLAN_REASON_CODE wlanReasonCode;
DWORD dwFlags;
WCHAR strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;
Miembros
wlanConnectionMode
Valor WLAN_CONNECTION_MODE que especifica el modo de la conexión.
Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Solo se admite el valor de wlan_connection_mode_profile .
strProfileName[WLAN_MAX_NAME_LENGTH]
Nombre del perfil usado para la conexión. WLAN_MAX_NAME_LENGTH es 256. Los nombres de perfil distinguen mayúsculas de minúsculas. Esta cadena debe terminar en NULL.
dot11Ssid
Estructura DOT11_SSID que contiene el SSID de la asociación.
dot11BssType
Valor DOT11_BSS_TYPE que indica el tipo de red BSS.
bSecurityEnabled
Indica si la seguridad está habilitada para esta conexión. Si es TRUE, la seguridad está habilitada.
wlanReasonCode
Un WLAN_REASON_CODE que indica el motivo de un error de operación. Este campo tiene un valor de WLAN_REASON_CODE_SUCCESS para todas las notificaciones relacionadas con la conexión, excepto wlan_notification_acm_connection_complete. Si se produce un error en la conexión, este campo indica el motivo del error.
dwFlags
Conjunto de marcas que proporcionan información adicional para la conexión de red.
Este miembro puede ser uno de los siguientes valores definidos en el archivo de encabezado Wlanapi.h .
strProfileXml[1]
Este campo contiene la presentación XML del perfil utilizado para la detección, si la conexión se realiza correctamente.
Comentarios
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.
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_ACM, la notificación recibida es una notificación del módulo de configuración automática. 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. Para algunas de estas notificaciones, se devuelve una estructura WLAN_CONNECTION_NOTIFICATION_DATA en el 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 .
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] |
| Encabezado | wlanapi.h |
| Redistribuible | API de LAN inalámbrica para Windows XP con SP2 |