wlanapi.h) (WlanSetAutoConfigParameter 函数

  • 项目

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 参数的大小（以字节为单位）。 对于 BOOL 或 sizeof(DWORD) DWORD，此参数必须设置为 sizeof(BOOL) ，具体取决于 OpCode 参数的值。

[in] pData

要为 OpCode 参数中指定的参数设置的值。 pData 参数必须指向布尔值或 DWORD 值，具体取决于 OpCode 参数的值。 pData 参数不能为 NULL。

注意 当需要布尔值时， pData 参数可能指向整数值。 如果 pData 指向 0，则该值将转换为 FALSE。 如果 pData 指向非零整数，则该值将转换为 TRUE。
 

pReserved

保留供将来使用。 必须设置为 NULL。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码 说明
ERROR_ACCESS_DENIED
 访问被拒绝。 如果调用方在 opCode 参数wlan_autoconf_opcode_show_denied_networks或wlan_autoconf_opcode_allow_virtual_station_extensibility时没有足够的权限设置配置参数，则返回此错误。 当 OpCode 参数设置为这些值之一时， WlanSetAutoConfigParameter 函数将检索为 opcode 对象存储 (DACL) 自由访问控制列表。 如果 DACL 不包含 (ACE) 授予对调用线程的访问令牌WLAN_WRITE_ACCESS权限的访问控制项，则 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 值之一，也会返回此错误。 如果 dwDataSize 参数未设置为 sizeof(BOOL)，或者 dwDataSize 未设置为 sizeof(BOOL) ，则也会返回此错误，具体取决于 OpCode 参数的值。
ERROR_INVALID_HANDLE
 在句柄表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。
RPC_STATUS
 各种错误代码。

注解

WlanSetAutoConfigParameter 函数设置自动配置模块 (ACM) （Windows Vista 及更高版本上支持的无线配置组件）使用的参数。

根据 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