WLAN_CONNECTION_NOTIFICATION_DATA-Struktur (wlanapi.h)
Die WLAN_CONNECTION_NOTIFICATION_DATA-Struktur enthält Informationen zu verbindungsbezogenen Benachrichtigungen.
Syntax
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;
Member
wlanConnectionMode
Ein WLAN_CONNECTION_MODE Wert, der den Modus der Verbindung angibt.
Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Nur der wlan_connection_mode_profile Wert wird unterstützt.
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.
bSecurityEnabled
Gibt an, ob die Sicherheit für diese Verbindung aktiviert ist. Bei TRUE ist die Sicherheit aktiviert.
wlanReasonCode
Eine WLAN_REASON_CODE , die den Grund für einen Vorgangsfehler angibt. Dieses Feld hat den Wert WLAN_REASON_CODE_SUCCESS für alle verbindungsbezogenen Benachrichtigungen mit Ausnahme von wlan_notification_acm_connection_complete. Wenn die Verbindung fehlschlägt, gibt dieses Feld den Grund für den Fehler an.
dwFlags
Eine Reihe von Flags, die zusätzliche Informationen für die Netzwerkverbindung bereitstellen.
Bei diesem Member kann es sich um einen der folgenden Werte handeln, die in der Headerdatei "Wlanapi.h " definiert sind.
strProfileXml[1]
Dieses Feld enthält die XML-Darstellung des für die Ermittlung verwendeten Profils, wenn die Verbindung erfolgreich ist.
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_ACM ist, handelt es sich bei der empfangenen Benachrichtigung um eine Modulbenachrichtigung für die automatische Konfiguration. 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_CONNECTION_NOTIFICATION_DATA-Struktur im pData-MemberWLAN_NOTIFICATION_DATA-Struktur zurückgegeben.
Weitere Informationen zu diesen Benachrichtigungen finden Sie unter WLAN_NOTIFICATION_ACM Enumerationsreferenz.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | wlanapi.h |
| Verteilbare Komponente | Wlan-API für Windows XP mit SP2 |