WLAN_CONNECTION_PARAMETERS-Struktur (wlanapi.h)

  • Artikel

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

Weitere Informationen

WlanConnect