WLAN_MSM_NOTIFICATION_DATA-Struktur (wlanapi.h)
Die WLAN_MSM_NOTIFICATION_DATA-Struktur enthält Informationen zu msM-bezogenen Benachrichtigungen (Media Specific Module).
Syntax
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;
Member
wlanConnectionMode
Ein WLAN_CONNECTION_MODE Wert, der den Modus der Verbindung angibt.
strProfileName[WLAN_MAX_NAME_LENGTH]
Der Name des für die Verbindung verwendeten Profils. WLAN_MAX_NAME_LENGTH ist 256. Bei Profilnamen wird die Groß-/Kleinschreibung beachtet. Diese Zeichenfolge muss NULL-beendet sein.
dot11Ssid
Eine DOT11_SSID-Struktur , die die SSID der Zuordnung enthält.
dot11BssType
Ein DOT11_BSS_TYPE Wert, der den BSS-Netzwerktyp angibt.
dot11MacAddr
Eine DOT11_MAC_ADDRESS , die die MAC-Adresse des Peers oder Zugriffspunkts angibt.
bSecurityEnabled
Gibt an, ob die Sicherheit für diese Verbindung aktiviert ist. Bei TRUE ist die Sicherheit aktiviert.
bFirstPeer
Gibt an, ob der Peer der erste ist, der dem vom Computer erstellten Ad-hoc-Netzwerk beigetreten ist. Wenn TRUE, ist der Peer der erste, der beitreten wird.
Nachdem der erste Peer das Netzwerk verknüpft hat, ändert sich der Schnittstellenstatus des Computers, der das Ad-hoc-Netzwerk erstellt hat, von wlan_interface_state_ad_hoc_network_formed zu wlan_interface_state_connected.
bLastPeer
Gibt an, ob der Peer der letzte ist, der das vom Computer erstellte Ad-hoc-Netzwerk verlässt. Wenn true, ist der Peer der letzte, der verlässt. Nachdem der letzte Peer das Netzwerk verlassen hat, ändert sich der Schnittstellenstatus des Computers, der das Ad-hoc-Netzwerk erstellt hat, von wlan_interface_state_connected zu wlan_interface_state_ad_hoc_network_formed.
wlanReasonCode
Eine WLAN_REASON_CODE , die den Grund für einen Vorgangsfehler angibt. Wenn der Vorgang erfolgreich ist, weist dieses Feld den Wert WLAN_REASON_CODE_SUCCESS auf. Andernfalls gibt dieses Feld den Grund für den Fehler an.
Hinweise
Die WlanRegisterNotification-Funktion wird von einer Anwendung verwendet, um Benachrichtigungen auf allen Drahtlosschnittstellen zu registrieren und aufzuheben. Bei der Registrierung für Benachrichtigungen muss eine Anwendung eine Rückruffunktion bereitstellen, auf die der funcCallback-Parameter verweist, der an die WlanRegisterNotification-Funktion übergeben wird. Der Prototyp für diese Rückruffunktion ist die WLAN_NOTIFICATION_CALLBACK. Diese Rückruffunktion empfängt Benachrichtigungen, die im dwNotifSource-Parameter registriert wurden, die an die WlanRegisterNotification-Funktion übergeben werden.
Die Rückruffunktion wird mit einem Zeiger auf eine WLAN_NOTIFICATION_DATA-Struktur als ersten Parameter aufgerufen, der detaillierte Informationen zur Benachrichtigung enthält.
Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_MSM ist, ist die empfangene Benachrichtigung eine medienspezifische Modulbenachrichtigung (MSM). Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA Struktur. Für einige dieser Benachrichtigungen wird eine WLAN_MSM_NOTIFICATION_DATA-Struktur im pData-MemberWLAN_NOTIFICATION_DATA-Struktur zurückgegeben.
Weitere Informationen zu diesen Benachrichtigungen finden Sie unter WLAN_NOTIFICATION_MSM Enumerationsreferenz.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | wlanapi.h |