次の方法で共有


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 パラメーターのサイズ (バイト単位)。 dwDataSizepData に割り当てられた実際のメモリ量よりも大きい場合、呼び出し元のプログラムでアクセス違反が発生します。

[in] pData

OpCode パラメーターで指定された値を設定します。 pData が指すデータの種類は、指定された OpCode に適している必要があります。 上の表を使用して、使用するデータの種類を決定します。

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

pReserved

将来利用するために予約されています。 NULL に設定する必要があります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。

注釈

OpCodewlan_intf_opcode_current_operation_mode に設定すると、WlanSetInterface 関数によってワイヤレス インターフェイスの現在の動作モードが設定されます。 操作モードの詳細については、「 ネイティブ 802.11 操作モード」を参照してください。 DOT11_OPERATION_MODE_EXTENSIBLE_STATIONDOT11_OPERATION_MODE_NETWORK_MONITORの 2 つの操作モードがサポートされています。 操作モードの定数は、ヘッダー ファイル Windot11.h で定義されます。 OpCodewlan_intf_opcode_current_operation_mode に設定されているときに pData がこれらの値のいずれかを指していない場合、WlanSetInterface 関数はエラーで失敗します。

コマンド ラインで自動構成サービスを有効または無効にするには(機能的には、OpCodewlan_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

こちらもご覧ください

ワイヤレス ホステッド ネットワークについて

DOT11_BSS_TYPE

WLAN_INTF_OPCODE

WLAN_PHY_RADIO_STATE

WlanQueryInterface