Share via

WlanSetAutoConfigParameter 関数 (wlanapi.h)

  • [アーティクル]

WlanSetAutoConfigParameter 関数は、自動構成サービスのパラメーターを設定します。

構文

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

パラメーター

[in] hClientHandle

WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。

[in] OpCode

設定するパラメーターを指定する WLAN_AUTOCONF_OPCODE 値。 WLAN_AUTOCONF_OPCODE列挙の一部のオペコードのみがセット操作をサポートします。

値 意味
wlan_autoconf_opcode_show_denied_networks
 設定すると、 pData パラメーターには、ユーザーとグループ のポリシーが拒否されたネットワークが使用可能なネットワークの一覧に含まれるかどうかを示す BOOL 値が含まれます。
wlan_autoconf_opcode_allow_explicit_creds
 pData パラメーターを設定すると、現在のワイヤレス インターフェイスで共有ユーザー資格情報が許可されているかどうかを示す BOOL 値が含まれます。
wlan_autoconf_opcode_block_period
 設定すると、 pData パラメーターには、現在のワイヤレス インターフェイスのブロック期間設定の DWORD 値が含まれます。 ブロック期間は、前回の障害が発生した後にワイヤレス ネットワークへの自動接続が試行されない時間 (秒単位) です。
wlan_autoconf_opcode_allow_virtual_station_extensibility
 設定すると、 pData パラメーターには、仮想ステーションでの機能拡張が許可されているかどうかを示す BOOL 値が含まれます。 既定では、仮想ステーションでの機能拡張が許可されます。 このオペコードの値は、再起動後も保持されます。

この列挙値は、ワイヤレス LAN サービスがインストールされている Windows 7 および Windows Server 2008 R2 でサポートされています。

[in] dwDataSize

pData パラメーターのサイズ (バイト単位)。 このパラメーターは、OpCode パラメーターの値に応じて、BOOL または sizeof(DWORD) DWORD の場合は に設定sizeof(BOOL)する必要があります。

[in] pData

OpCode パラメーターで指定されたパラメーターに設定する値。 pData パラメーターは、OpCode パラメーターの値に応じて、ブール値または DWORD 値を指す必要があります。 pData パラメーターは NULL にすることはできません。

メモ ブール値が必要な場合、 pData パラメーターは整数値を指す場合があります。 pData が 0 を指す場合、値は FALSE に変換されます。 pData が 0 以外の整数を指している場合、値は TRUE に変換されます。
 

pReserved

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

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 アクセスが拒否されました。 このエラーは、 OpCode パラメーターがwlan_autoconf_opcode_show_denied_networksまたはwlan_autoconf_opcode_allow_virtual_station_extensibilityのときに、呼び出し元に構成パラメーターを設定するための十分なアクセス許可がない場合に返されます。 OpCode パラメーターがこれらの値のいずれかに設定されている場合、WlanSetAutoConfigParameter 関数は、オペコード オブジェクト用に格納されている随意アクセス制御リスト (DACL) を取得します。 DACL に、呼び出し元スレッドのアクセス トークンにWLAN_WRITE_ACCESSアクセス許可を付与するアクセス制御エントリ (ACE) が含まれていない場合、WlanSetAutoConfigParameter はERROR_ACCESS_DENIEDを返します。

このエラーは、構成パラメーターがドメインのグループ ポリシーによって設定されている場合にも返されます。 オペコードに対してグループ ポリシーが設定されている場合、アプリケーションは変更を加えなくなります。 次の OpCode パラメーターは、グループ ポリシーによって設定できます:wlan_autoconf_opcode_show_denied_networks、wlan_autoconf_opcode_allow_explicit_creds、およびwlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。 このエラーは、hClientHandle パラメーターが NULL、pData パラメーターが NULL、または pReserved パラメーターが NULL でない場合に返されます。 このエラーは、 指定された OpCode パラメーターが、設定できる構成パラメーターの WLAN_AUTOCONF_OPCODE 値の 1 つではない場合にも返されます。 このエラーは、dwDataSize パラメーターが にsizeof(BOOL)設定されていない場合、または OpCode パラメーターの値に応じて dwDataSize が にsizeof(BOOL)設定されていない場合にも返されます。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
ERROR_NOT_SUPPORTED
 この関数は、サポートされていないプラットフォームから呼び出されました。 この関数が SP3 の Windows XP から呼び出された場合、または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API から呼び出された場合、この値が返されます。
RPC_STATUS
 さまざまなエラー コード。

注釈

WlanSetAutoConfigParameter 関数は、Windows Vista 以降でサポートされているワイヤレス構成コンポーネントである自動構成モジュール (ACM) で使用されるパラメーターを設定します。

OpCode パラメーターの値に応じて、pData が指すデータは、自動構成パラメーターが設定される前にブール値に変換されます。 pData が 0 を指す場合、パラメーターは FALSE に設定されます。それ以外の場合、パラメーターは TRUE に設定されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h (Wlanapi.h を含む)
Library Wlanapi.lib
[DLL] Wlanapi.dll

こちらもご覧ください

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter