wlanapi.h (wlanihvControl 函数)

  • 项目

WlanIhvControl 函数为独立硬件供应商提供了一种机制， (IHV) WLAN 驱动程序或服务的控制。

语法

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

参数

[in] hClientHandle

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

[in] pInterfaceGuid

接口的 GUID。

[in] Type

WLAN_IHV_CONTROL_TYPE结构，指定 IHV 控制函数绕过的软件类型。

[in] dwInBufferSize

输入缓冲区的大小（以字节为单位）。

[in] pInBuffer

驱动程序或服务接口输入的通用缓冲区。

[in] dwOutBufferSize

输出缓冲区的大小（以字节为单位）。

[in, out, optional] pOutBuffer

驱动程序或服务接口输出的通用缓冲区。

[out] pdwBytesReturned

返回的字节数。

返回值

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

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

返回代码 说明
ERROR_ACCESS_DENIED
 调用方没有足够的权限来执行此操作。 调用时， WlanIhvControl 检索随 wlan_secure_ihv_control 对象一起存储 (DACL ) 自由访问控制列表。 如果 DACL 不包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE) (访问控制项，则 WlanIhvControl 将返回 ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 为 NULL 或无效， pInterfaceGuid 为 NULL，或 pdwBytesReturned 为 NULL。
ERROR_INVALID_HANDLE
 在句柄表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。
RPC_STATUS
 各种错误代码。

要求

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

另请参阅

WLAN_IHV_CONTROL_TYPE