Share via

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

こちらもご覧ください

WlanConnect