Share via

WlanQueryAutoConfigParameter 関数 (wlanapi.h)

  • [アーティクル]

WlanQueryAutoConfigParameter 関数は、自動構成サービスのパラメーターを照会します。

構文

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

パラメーター

[in] hClientHandle

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

[in] OpCode

クエリを実行する構成パラメーターを指定する 値。

値 意味
wlan_autoconf_opcode_show_denied_networks
 設定すると、 ppData パラメーターには、ユーザーとグループのポリシーが拒否されたネットワークが使用可能なネットワークの一覧に含まれるかどうかを示す BOOL 値が含まれます。

関数がERROR_SUCCESSを返し、 ppData が TRUE をポイントする場合、ユーザーとグループのポリシーが拒否されたネットワークは、使用可能なネットワークの一覧に含まれます。 FALSE の場合、ユーザーおよびグループ ポリシーで拒否されたネットワークは、使用可能なネットワークの一覧に含まれません。
wlan_autoconf_opcode_power_setting
 設定すると、 ppData パラメーターには電源設定を指定する WLAN_POWER_SETTING 値が含まれます。
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks
 ppData パラメーターを設定すると、グループ ポリシーによって作成されていないプロファイルを使用して、一致するグループ ポリシー プロファイルを使用して許可されたネットワークに接続できるかどうかを示す BOOL 値が含まれます。

関数がERROR_SUCCESSを返し、 ppData が TRUE を指している場合は、グループ ポリシーによって作成されたプロファイルのみを使用できます。 FALSE の場合は、任意のプロファイルを使用できます。
wlan_autoconf_opcode_allow_explicit_creds
 設定すると、 ppData パラメーターには、現在のワイヤレス インターフェイスで共有ユーザー資格情報が許可されているかどうかを示す BOOL 値が含まれます。

関数がERROR_SUCCESSを返し、 ppData が TRUE を指している場合、現在のワイヤレス インターフェイスでは共有ユーザー資格情報が許可されます。 FALSE の場合、現在のワイヤレス インターフェイスでは共有ユーザー資格情報は許可されません。
wlan_autoconf_opcode_block_period
 設定すると、 ppData パラメーターには、現在のワイヤレス インターフェイスのブロック期間の設定を示す DWORD 値が含まれます。 ブロック期間は、以前の障害が発生した後にワイヤレス ネットワークへの自動接続が試行されない時間 (秒単位) です。
wlan_autoconf_opcode_allow_virtual_station_extensibility
 設定すると、 ppData パラメーターには、仮想ステーションでの機能拡張が許可されるかどうかを示す BOOL 値が含まれます。 既定では、仮想ステーションでの機能拡張が許可されます。 このオペコードの値は、再起動後も保持されます。

関数がERROR_SUCCESSを返し、 ppData が TRUE を指している場合は、仮想ステーションでの機能拡張が許可されます。 FALSE の場合、仮想ステーションでの機能拡張は許可されません。

pReserved

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

[out] pdwDataSize

ppData パラメーターのサイズをバイト単位で指定します。

[out] ppData

OpCode で指定されたパラメーターのクエリ値を含むメモリへのポインター。

メモOpCode が wlan_autoconf_opcode_show_denied_networks に設定されている場合、ppData によって参照されるポインターが整数値を指している可能性があります。 ppData によって参照されるポインターが 0 をポイントする場合、整数値はブール値 FALSE に変換されます。 ppData によって参照されるポインターが 0 以外の整数を指している場合、整数値はブール値 TRUE に変換されます。
 

[out, optional] pWlanOpcodeValueType

WLAN_OPCODE_VALUE_TYPE値。

戻り値

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

関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、構成パラメーターを取得するための十分なアクセス許可がありません。

OpCode をwlan_autoconf_opcode_show_denied_networks に設定して呼び出されると、WlanQueryAutoConfigParameter は、wlan_secure_show_denied オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 DACL に、呼び出し元スレッドのアクセス トークンに対するアクセス許可WLAN_READ_ACCESS付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanQueryAutoConfigParameter は ERROR_ACCESS_DENIEDを返します。
ERROR_INVALID_PARAMETER
 hClientHandle が NULL または無効、 pReserved が NULL ではない、 ppData が NULL、 または pdwDataSize が NULL です。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
ERROR_NOT_SUPPORTED
 この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。
RPC_STATUS
 さまざまなエラー コード。

注釈

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

要件

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

こちらもご覧ください

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter