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 引用的指针指向非零整数，则应将整数值转换为布尔值 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 函数查询自动配置模块 (ACM) （Windows Vista 及更高版本支持的无线配置组件）使用的参数。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

另请参阅

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter