WlanSetInterface 関数 (wlanapi.h)
WlanSetInterface 関数は、指定されたインターフェイスに対してユーザーが構成可能なパラメーターを設定します。
構文
DWORD WlanSetInterface(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] WLAN_INTF_OPCODE OpCode,
[in] DWORD dwDataSize,
[in] const PVOID pData,
PVOID pReserved
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。
[in] pInterfaceGuid
構成するインターフェイスの GUID。
[in] OpCode
設定するパラメーターを指定する WLAN_INTF_OPCODE 値。 次の表に、 pData のパラメーターのデータ型と共に有効な定数を示します。
| WLAN_INTF_OPCODE 値 | pData データ型 | 説明 |
|---|---|---|
| wlan_intf_opcode_autoconf_enabled | BOOL | 指定されたインターフェイスの自動構成を有効または無効にします。 |
| wlan_intf_opcode_background_scan_enabled | BOOL | 指定されたインターフェイスのバックグラウンド スキャンを有効または無効にします。 |
| wlan_intf_opcode_radio_state | WLAN_PHY_RADIO_STATE | インターフェイスの特定の物理層 (PHY) のソフトウェア 無線状態を設定します。 |
| wlan_intf_opcode_bss_type | DOT11_BSS_TYPE | BSS 型を設定します。 |
| wlan_intf_opcode_media_streaming_mode | BOOL | ドライバーのメディア ストリーミング モードを設定します。 |
| wlan_intf_opcode_current_operation_mode | ULONG | インターフェイスの現在の操作モードを設定します。 詳細については、「解説」を参照してください。 |
WINDOWS XP SP3 とワイヤレス LAN API for Windows XP SP2: wlan_intf_opcode_autoconf_enabled定数とwlan_intf_opcode_bss_type定数のみが有効です。
[in] dwDataSize
pData パラメーターのサイズ (バイト単位)。 dwDataSize が pData に割り当てられた実際のメモリ量よりも大きい場合、呼び出し元のプログラムでアクセス違反が発生します。
[in] pData
OpCode パラメーターで指定された値を設定します。 pData が指すデータの種類は、指定された OpCode に適している必要があります。 上の表を使用して、使用するデータの種類を決定します。
pReserved
将来利用するために予約されています。 NULL に設定する必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
注釈
OpCode を wlan_intf_opcode_current_operation_mode に設定すると、WlanSetInterface 関数によってワイヤレス インターフェイスの現在の動作モードが設定されます。 操作モードの詳細については、「 ネイティブ 802.11 操作モード」を参照してください。 DOT11_OPERATION_MODE_EXTENSIBLE_STATIONとDOT11_OPERATION_MODE_NETWORK_MONITORの 2 つの操作モードがサポートされています。 操作モードの定数は、ヘッダー ファイル Windot11.h で定義されます。 OpCode が wlan_intf_opcode_current_operation_mode に設定されているときに pData がこれらの値のいずれかを指していない場合、WlanSetInterface 関数はエラーで失敗します。
コマンド ラインで自動構成サービスを有効または無効にするには(機能的には、OpCode を wlan_intf_opcode_autoconf_enabled に設定した WlanSetInterface を呼び出すのと同じです)、netsh wlan setautoconfig コマンドを使用します。 詳細については、「 ワイヤレス ローカル エリア ネットワーク (wlan) の Netsh コマンド」を参照してください。
ソフトウェア無線の状態は 、WlanSetInterface 関数を呼び出すことによって変更できます。 WlanSetInterface 関数を呼び出して、ハードウェア無線の状態を変更することはできません。 OpCode パラメーターが wlan_intf_opcode_radio_state に設定されている場合、WlanSetInterface 関数は特定の PHY のソフトウェア 無線状態を設定します。 pData パラメーターは、使用する新しい無線状態値を持つWLAN_PHY_RADIO_STATE構造体を指す必要があります。 WLAN_PHY_RADIO_STATE 構造体の dot11HardwareRadioState メンバーは、OpCode パラメーターを wlan_intf_opcode_radio_state に設定して WlanSetInterface 関数が呼び出され、pData パラメーターがWLAN_PHY_RADIO_STATE構造体を指している場合は無視されます。 ソフトウェア無線状態 (WLAN_PHY_RADIO_STATE 構造体の dot11SoftwareRadioState メンバー) またはハードウェア無線状態 (WLAN_PHY_RADIO_STATE構造体の dot11HardwareRadioState メンバー) のいずれかがオフの場合、PHY の無線状態はオフになります。
物理ネットワーク インターフェイスのソフトウェア無線状態を変更すると、ワイヤレス ホスト型ネットワークまたは仮想ワイヤレス アダプターの無線状態に関連する変更が発生する可能性があります。 すべての仮想ワイヤレス アダプターの PHY がリンクされます。 詳細については、「 ワイヤレス ホステッド ネットワークについて」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP3 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wlanapi.h (Wlanapi.h を含む) |
| Library | Wlanapi.lib |
| [DLL] | Wlanapi.dll |
| 再頒布可能パッケージ | Sp2 を使用した Windows XP 用ワイヤレス LAN API |