WlanSetInterface 関数 (wlanapi.h)

[アーティクル]
08/28/2023

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 に適している必要があります。上の表を使用して、使用するデータの種類を決定します。

メモOpCode がwlan_intf_opcode_autoconf_enabled、wlan_intf_opcode_background_scan_enabled、またはwlan_intf_opcode_media_streaming_modeに設定されている場合、pData は整数値を指している可能性があります。 pData が 0 を指す場合、値は FALSE に変換されます。 pData が 0 以外の整数を指している場合、値は TRUE に変換されます。

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