structure WLAN_CONNECTION_NOTIFICATION_DATA (wlanapi.h)

Article
03/04/2024

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 .

Valeur	Signification
WLAN_CONNECTION_NOTIFICATION_ADHOC_NETWORK_FORMED	Indique qu’un réseau ad hoc est formé.
WLAN_CONNECTION_NOTIFICATION_CONSOLE_USER_PROFILE	Indique que la connexion utilise un profil par utilisateur appartenant à l’utilisateur de la console. Les utilisateurs hors console ne pourront pas voir le profil dans leur liste de profils.

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

Voir aussi

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification

Share via