EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

WLAN_CONNECTION_PARAMETERS structure

The WLAN_CONNECTION_PARAMETERS structure specifies the parameters used when using the WlanConnect function.

Syntax


typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
  LPCWSTR              strProfile;
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Members

wlanConnectionMode

A WLAN_CONNECTION_MODE value that specifies the mode of connection.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2:  Only the wlan_connection_mode_profile value is supported.

strProfile

Specifies the profile being used for the connection.

If wlanConnectionMode is set to wlan_connection_mode_profile, then strProfile specifies the name of the profile used for the connection. If wlanConnectionMode is set to wlan_connection_mode_temporary_profile, then strProfile specifies the XML representation of the profile used for the connection. If wlanConnectionMode is set to wlan_connection_mode_discovery_secure or wlan_connection_mode_discovery_unsecure, then strProfile should be set to NULL.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2:  The profile must meet the compatibility criteria described in Wireless Profile Compatibility.

pDot11Ssid

Pointer to a DOT11_SSID structure that specifies the SSID of the network to connect to. This parameter is optional. When set to NULL, all SSIDs in the profile will be tried. This parameter must not be NULL if WLAN_CONNECTION_MODE is set to wlan_connection_mode_discovery_secure or wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Pointer to a DOT11_BSSID_LIST structure that contains the list of basic service set (BSS) identifiers desired for the connection.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2:  This member must be NULL.

dot11BssType

A DOT11_BSS_TYPE value that indicates the BSS type of the network. If a profile is provided, this BSS type must be the same as the one in the profile.

dwFlags

The following table shows flags used to specify the connection parameters.

ConstantValueDescription
WLAN_CONNECTION_HIDDEN_NETWORK0x00000001Connect to the destination network even if the destination is a hidden network. A hidden network does not broadcast its SSID. Do not use this flag if the destination network is an ad-hoc network.

If the profile specified by strProfile is not NULL, then this flag is ignored and the nonBroadcast profile element determines whether to connect to a hidden network.

WLAN_CONNECTION_ADHOC_JOIN_ONLY0x00000002Do not form an ad-hoc network. Only join an ad-hoc network if the network already exists. Do not use this flag if the destination network is an infrastructure network.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT0x00000004Ignore the privacy bit when connecting to the network. Ignoring the privacy bit has the effect of ignoring whether packets are encrypted and ignoring the method of encryption used. Only use this flag when connecting to an infrastructure network using a temporary profile.
WLAN_CONNECTION_EAPOL_PASSTHROUGH 0x00000008Exempt EAPOL traffic from encryption and decryption. This flag is used when an application must send EAPOL traffic over an infrastructure network that uses Open authentication and WEP encryption. This flag must not be used to connect to networks that require 802.1X authentication. This flag is only valid when wlanConnectionMode is set to wlan_connection_mode_temporary_profile. Avoid using this flag whenever possible.

 

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2:  This member must be set to 0.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP3 [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Redistributable

Wireless LAN API for Windows XP with SP2

Header

Wlanapi.h

See also

WlanConnect

 

 

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft