WLAN_CONNECTION_PARAMETERS-Struktur (wlanapi.h)
Die WLAN_CONNECTION_PARAMETERS-Struktur gibt die Parameter an, die bei Verwendung der WlanConnect-Funktion verwendet werden.
Syntax
typedef struct _WLAN_CONNECTION_PARAMETERS {
WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
LPCWSTR strProfile;
#else
LPCWSTR strProfile;
#endif
PDOT11_SSID pDot11Ssid;
PDOT11_BSSID_LIST pDesiredBssidList;
DOT11_BSS_TYPE dot11BssType;
DWORD dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;
Member
wlanConnectionMode
Ein WLAN_CONNECTION_MODE Wert, der den Verbindungsmodus angibt.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Nur der wlan_connection_mode_profile-Wert wird unterstützt.
strProfile
Gibt das Profil an, das für die Verbindung verwendet wird.
Wenn wlanConnectionMode auf wlan_connection_mode_profile festgelegt ist, gibt strProfile den Namen des Profils an, das für die Verbindung verwendet wird. Wenn wlanConnectionMode auf wlan_connection_mode_temporary_profile festgelegt ist, gibt strProfile die XML-Darstellung des profils an, das für die Verbindung verwendet wird. Wenn wlanConnectionMode auf wlan_connection_mode_discovery_secure oder wlan_connection_mode_discovery_unsecure festgelegt ist, sollte strProfile auf NULL festgelegt werden.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Das Profil muss die unter Kompatibilität des Drahtlosprofils beschriebenen Kompatibilitätskriterien erfüllen.
pDot11Ssid
Zeiger auf eine DOT11_SSID-Struktur , die die SSID des Netzwerks angibt, mit dem eine Verbindung hergestellt werden soll. Dieser Parameter ist optional. Wenn diese Einstellung auf NULL festgelegt ist, werden alle SSIDs im Profil versucht. Dieser Parameter darf nicht NULL sein, wenn WLAN_CONNECTION_MODE auf wlan_connection_mode_discovery_secure oder wlan_connection_mode_discovery_unsecure festgelegt ist.
pDesiredBssidList
Zeiger auf eine DOT11_BSSID_LIST-Struktur , die die Liste der für die Verbindung gewünschten BSS-Bezeichner (Basic Service Set) enthält.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieser Member muss NULL sein.
dot11BssType
Ein DOT11_BSS_TYPE Wert, der den BSS-Typ des Netzwerks angibt. Wenn ein Profil bereitgestellt wird, muss dieser BSS-Typ mit dem im Profil identisch sein.
dwFlags
In der folgenden Tabelle sind Flags aufgeführt, die zum Angeben der Verbindungsparameter verwendet werden.
| Konstante | Wert | BESCHREIBUNG |
|---|---|---|
| WLAN_CONNECTION_HIDDEN_NETWORK | 0x00000001 | Stellen Sie eine Verbindung mit dem Zielnetzwerk her, auch wenn das Ziel ein ausgeblendetes Netzwerk ist. Ein ausgeblendetes Netzwerk sendet seine SSID nicht. Verwenden Sie dieses Flag nicht, wenn das Zielnetzwerk ein Ad-hoc-Netzwerk ist. Wenn das durch strProfile angegebene Profil nicht NULL ist, wird dieses Flag ignoriert, und das profilelement nonBroadcast bestimmt, ob eine Verbindung mit einem ausgeblendeten Netzwerk hergestellt werden soll. |
| WLAN_CONNECTION_ADHOC_JOIN_ONLY | 0x00000002 | Bilden Sie kein Ad-hoc-Netzwerk. Treten Sie nur einem Ad-hoc-Netzwerk bei, wenn das Netzwerk bereits vorhanden ist. Verwenden Sie dieses Flag nicht, wenn das Zielnetzwerk ein Infrastrukturnetzwerk ist. |
| WLAN_CONNECTION_IGNORE_PRIVACY_BIT | 0x00000004 | Ignorieren Sie das Datenschutzbit, wenn Sie eine Verbindung mit dem Netzwerk herstellen. Das Ignorieren des Datenschutzbits führt dazu, dass ignoriert wird, ob Pakete verschlüsselt sind, und die verwendete Verschlüsselungsmethode ignoriert wird. Verwenden Sie dieses Flag nur, wenn Sie mithilfe eines temporären Profils eine Verbindung mit einem Infrastrukturnetzwerk herstellen. |
| WLAN_CONNECTION_EAPOL_PASSTHROUGH | 0x00000008 | Eapol-Datenverkehr von der Verschlüsselung und Entschlüsselung ausgenommen. Dieses Flag wird verwendet, wenn eine Anwendung EAPOL-Datenverkehr über ein Infrastrukturnetzwerk senden muss, das die Open-Authentifizierung und WEP-Verschlüsselung verwendet. Dieses Flag darf nicht zum Herstellen einer Verbindung mit Netzwerken verwendet werden, die eine 802.1X-Authentifizierung erfordern. Dieses Flag ist nur gültig, wenn wlanConnectionMode auf wlan_connection_mode_temporary_profile festgelegt ist. Vermeiden Sie nach Möglichkeit die Verwendung dieses Flags. |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE | 0x00000010 | Das Ermittlungsprofil wird bei erfolgreichem Verbindungsabschluss automatisch beibehalten. Dieses Flag ist nur für wlan_connection_mode_discovery_secure oder wlan_connection_mode_discovery_unsecure gültig. Das Profil wird als All-Benutzerprofil gespeichert, wobei der Name aus der SSID mithilfe von WlanUtf8SsidToDisplayName generiert wird. Wenn bereits ein Profil mit demselben Namen vorhanden ist, wird am Ende des Profilnamens eine Zahl angefügt. Das Profil wird im manuellen Verbindungsmodus gespeichert, es sei denn, WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO wird ebenfalls angegeben. |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO | 0x00000020 | In Verbindung mit WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Das Ermittlungsprofil wird im automatischen Verbindungsmodus beibehalten. |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING | 0x00000040 | In Verbindung mit WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Das Ermittlungsprofil wird beibehalten und versucht, ein vorhandenes Profil mit demselben Namen zu überschreiben. |
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieser Member muss auf 0 festgelegt werden.
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 |