structure WLAN_CONNECTION_NOTIFICATION_DATA (wlanapi.h)
La structure WLAN_CONNECTION_NOTIFICATION_DATA contient des informations sur les notifications liées à la connexion.
Syntaxe
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;
Membres
wlanConnectionMode
Valeur WLAN_CONNECTION_MODE qui spécifie le mode de connexion.
Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Seule la valeur wlan_connection_mode_profile est prise en charge.
strProfileName[WLAN_MAX_NAME_LENGTH]
Nom du profil utilisé pour la connexion. WLAN_MAX_NAME_LENGTH est 256. Les noms de profil respectent la casse. Cette chaîne doit être terminée par null.
dot11Ssid
Structure DOT11_SSID qui contient le SSID de l’association.
dot11BssType
Valeur DOT11_BSS_TYPE qui indique le type de réseau BSS.
bSecurityEnabled
Indique si la sécurité est activée pour cette connexion. Si la valeur est TRUE, la sécurité est activée.
wlanReasonCode
WLAN_REASON_CODE qui indique la raison de l’échec d’une opération. Ce champ a la valeur WLAN_REASON_CODE_SUCCESS pour toutes les notifications liées à la connexion, à l’exception des wlan_notification_acm_connection_complete. Si la connexion échoue, ce champ indique la raison de l’échec.
dwFlags
Ensemble d’indicateurs qui fournissent des informations supplémentaires pour la connexion réseau.
Ce membre peut être l’une des valeurs suivantes définies dans le fichier d’en-tête Wlanapi.h .
strProfileXml[1]
Ce champ contient la présentation XML du profil utilisé pour la découverte, si la connexion réussit.
Remarques
La fonction WlanRegisterNotification est utilisée par une application pour inscrire et annuler l’inscription des notifications sur toutes les interfaces sans fil. Lors de l’inscription aux notifications, une application doit fournir une fonction de rappel pointée vers le paramètre funcCallback passé à la fonction WlanRegisterNotification . Le prototype de cette fonction de rappel est le WLAN_NOTIFICATION_CALLBACK. Cette fonction de rappel recevra des notifications qui ont été inscrites dans le paramètre dwNotifSource transmis à la fonction WlanRegisterNotification .
La fonction de rappel est appelée avec un pointeur vers une structure WLAN_NOTIFICATION_DATA comme premier paramètre qui contient des informations détaillées sur la notification.
Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_ACM, la notification reçue est une notification de module de configuration automatique. Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure. Pour certaines de ces notifications, une structure WLAN_CONNECTION_NOTIFICATION_DATA est retournée dans le membre pData de WLAN_NOTIFICATION_DATA structure.
Pour plus d’informations sur ces notifications, consultez la référence d’énumération WLAN_NOTIFICATION_ACM .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP3 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | wlanapi.h |
| Composant redistribuable | API LAN sans fil pour Windows XP avec SP2 |