WLAN_CONNECTION_PARAMETERS構造体 (wlanapi.h)
WLAN_CONNECTION_PARAMETERS構造体は、WlanConnect 関数の使用時に使用されるパラメーターを指定します。
構文
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;
メンバー
wlanConnectionMode
接続モードを指定する WLAN_CONNECTION_MODE 値。
SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: wlan_connection_mode_profile値のみがサポートされています。
strProfile
接続に使用するプロファイルを指定します。
wlanConnectionMode が wlan_connection_mode_profile に設定されている場合、strProfile は接続に使用されるプロファイルの名前を指定します。 wlanConnectionMode が wlan_connection_mode_temporary_profile に設定されている場合、strProfile は接続に使用されるプロファイルの XML 表現を指定します。 wlanConnectionMode が wlan_connection_mode_discovery_secure または wlan_connection_mode_discovery_unsecure に設定されている場合は、strProfile を NULL に設定する必要があります。
SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: プロファイルは、「 ワイヤレス プロファイルの互換性」で説明されている互換性基準を満たしている必要があります。
pDot11Ssid
接続するネットワークの SSID を指定する DOT11_SSID 構造体へのポインター。 このパラメーターは省略可能です。 NULL に設定すると、プロファイル内のすべての SSD が試行されます。 WLAN_CONNECTION_MODEが wlan_connection_mode_discovery_secureまたはwlan_connection_mode_discovery_unsecure に設定されている場合、このパラメーターは NULL にすることはできません。
pDesiredBssidList
接続に 必要な基本 サービス セット (BSS) 識別子の一覧を含むDOT11_BSSID_LIST構造体へのポインター。
SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: このメンバーは NULL である必要があります。
dot11BssType
ネットワークの BSS の種類を示す DOT11_BSS_TYPE 値。 プロファイルが指定されている場合、この BSS タイプはプロファイル内のタイプと同じである必要があります。
dwFlags
次の表は、接続パラメーターを指定するために使用されるフラグを示しています。
| 定数 | 値 | 説明 |
|---|---|---|
| WLAN_CONNECTION_HIDDEN_NETWORK | 0x00000001 | 宛先が非表示のネットワークである場合でも、宛先ネットワークに接続します。 非表示のネットワークでは、その SSID はブロードキャストされません。 宛先ネットワークがアドホック ネットワークの場合は、このフラグを使用しないでください。 strProfile で指定されたプロファイルが NULL でない場合、このフラグは無視され、 nonBroadcast プロファイル要素は非表示のネットワークに接続するかどうかを決定します。 |
| WLAN_CONNECTION_ADHOC_JOIN_ONLY | 0x00000002 | アドホック ネットワークを形成しないでください。 ネットワークが既に存在する場合にのみ、アドホック ネットワークに参加します。 宛先ネットワークがインフラストラクチャ ネットワークである場合は、このフラグを使用しないでください。 |
| WLAN_CONNECTION_IGNORE_PRIVACY_BIT | 0x00000004 | ネットワークに接続するときにプライバシー ビットを無視します。 プライバシー ビットを無視すると、パケットが暗号化されているかどうかを無視し、使用される暗号化方法を無視する効果があります。 このフラグは、一時プロファイルを使用してインフラストラクチャ ネットワークに接続する場合にのみ使用します。 |
| WLAN_CONNECTION_EAPOL_PASSTHROUGH | 0x00000008 | 暗号化と復号化から EAPOL トラフィックを除外します。 このフラグは、アプリケーションがオープン認証と WEP 暗号化を使用するインフラストラクチャ ネットワーク経由で EAPOL トラフィックを送信する必要がある場合に使用されます。 このフラグを使用して、802.1X 認証を必要とするネットワークに接続することはできません。 このフラグは、 wlanConnectionMode が wlan_connection_mode_temporary_profile に設定されている場合にのみ有効です。 可能な限り、このフラグを使用しないでください。 |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE | 0x00000010 | 接続が正常に完了したら、検出プロファイルを自動的に保持します。 このフラグは、wlan_connection_mode_discovery_secureまたはwlan_connection_mode_discovery_unsecureに対してのみ有効です。 プロファイルは、WlanUtf8SsidToDisplayName を使用して SSID から生成された名前で、すべてのユーザー プロファイルとして保存されます。 同じ名前のプロファイルが既にある場合は、プロファイル名の末尾に番号が追加されます。 WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTOも指定されていない限り、プロファイルは手動接続モードで保存されます。 |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO | 0x00000020 | WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILEと組み合わせて使用します。 検出プロファイルは、自動接続モードで保持されます。 |
| WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING | 0x00000040 | WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILEと組み合わせて使用します。 検出プロファイルは永続化され、同じ名前の既存のプロファイルを上書きしようとします。 |
SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: このメンバーは 0 に設定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP3 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | wlanapi.h |
| 再頒布可能パッケージ | Sp2 を使用した Windows XP 用ワイヤレス LAN API |