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 |