wlanapi.h) (WlanGetSecuritySettings 函数

  • 项目

WlanGetSecuritySettings 函数获取与可配置对象关联的安全设置。

语法

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

参数

[in] hClientHandle

客户端的会话句柄，由先前对 WlanOpenHandle 函数的调用获取。

[in] SecurableObject

一个 WLAN_SECURABLE_OBJECT值，该值指定应用安全设置的对象。

[out, optional] pValueType

指向 WLAN_OPCODE_VALUE_TYPE 值的指针，该值指定安全设置的源。

值 含义
wlan_opcode_value_type_set_by_group_policy
 安全设置由组策略设置。
wlan_opcode_value_type_set_by_user
 安全设置由用户设置。 用户可以通过调用 WlanSetSecuritySettings 来设置安全设置。

[out] pstrCurrentSDDL

输入时，此参数必须为 NULL。

输出时，如果函数调用成功，此参数将收到指向安全描述符字符串的指针，该字符串指定对象的安全设置。 有关此字符串的详细信息，请参阅 WlanSetSecuritySettings 函数。

[out] pdwGrantedAccess

对象的访问掩码。

值 含义
WLAN_READ_ACCESS
 调用方可以查看对象的权限。
WLAN_EXECUTE_ACCESS
 调用方可以从 中读取和执行 对象。 WLAN_EXECUTE_ACCESS的值与按位 OR 组合WLAN_READ_ACCESS相同 |WLAN_EXECUTE_ACCESS。
WLAN_WRITE_ACCESS
 调用方可以从对象读取、执行和写入对象。 WLAN_WRITE_ACCESS的值与按位 OR 组合WLAN_READ_ACCESS相同 |WLAN_EXECUTE_ACCESS |WLAN_WRITE_ACCESS。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
 参数不正确。 如果出现以下任一情况，则返回此错误：
  • hClientHandle 为 NULL。
  • pstrCurrentSDDL 为 NULL。
  • pdwGrantedAccess 为 NULL。
  • SecurableObject 设置为大于或等于 WLAN_SECURABLE_OBJECT_COUNT (12) 的值。
ERROR_INVALID_HANDLE
 句柄无效。 如果在句柄表中找不到 hClientHandle 参数中指定的句柄，则返回此错误。
ERROR_ACCESS_DENIED
 调用方没有足够的权限。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。

注解

如果函数成功，调用方负责释放分配给 pstrCurrentSDDL 参数指向的安全描述符字符串的内存。 不再需要时，应通过调用 WlanFreeMemory 函数并传入 pstrCurrentSDDL 参数来释放安全描述符字符串的内存。

要求

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

另请参阅

本机 Wifi API 权限

WlanFreeMemory

WlanSetSecuritySettings