structure WLAN_MSM_NOTIFICATION_DATA (wlanapi.h)

La structure WLAN_MSM_NOTIFICATION_DATA contient des informations sur les notifications liées à la connexion à un module multimédia (MSM).

Syntaxe

typedef struct _WLAN_MSM_NOTIFICATION_DATA {
  WLAN_CONNECTION_MODE wlanConnectionMode;
  WCHAR                strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID           dot11Ssid;
  DOT11_BSS_TYPE       dot11BssType;
  DOT11_MAC_ADDRESS    dot11MacAddr;
  BOOL                 bSecurityEnabled;
  BOOL                 bFirstPeer;
  BOOL                 bLastPeer;
  WLAN_REASON_CODE     wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;

Membres

wlanConnectionMode

Valeur WLAN_CONNECTION_MODE qui spécifie le mode de connexion.

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.

dot11MacAddr

DOT11_MAC_ADDRESS qui spécifie l’adresse MAC de l’homologue ou du point d’accès.

bSecurityEnabled

Indique si la sécurité est activée pour cette connexion. Si la valeur est TRUE, la sécurité est activée.

bFirstPeer

Indique si l’homologue est le premier à rejoindre le réseau ad hoc créé par l’ordinateur. Si la valeur est TRUE, l’homologue est le premier à rejoindre.

Une fois que le premier homologue a joint le réseau, l’état de l’interface de l’ordinateur qui a créé le réseau ad hoc passe de wlan_interface_state_ad_hoc_network_formed à wlan_interface_state_connected.

bLastPeer

Indique si l’homologue est le dernier à quitter le réseau ad hoc créé par l’ordinateur. Si la valeur est TRUE, l’homologue est le dernier à quitter. Une fois que le dernier homologue a quitté le réseau, l’état de l’interface de l’ordinateur qui a créé le réseau ad hoc passe de wlan_interface_state_connected à wlan_interface_state_ad_hoc_network_formed.

wlanReasonCode

WLAN_REASON_CODE qui indique la raison de l’échec d’une opération. Si l’opération réussit, ce champ a la valeur WLAN_REASON_CODE_SUCCESS. Sinon, ce champ indique la raison de l’échec.

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_MSM, la notification reçue est une notification msm (Media Specific Module). 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_MSM_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_MSM .

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h

Voir aussi

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification