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。
如果函数失败,则返回值可能是以下返回代码之一。
返回代码 | 说明 |
---|---|
|
调用方没有足够的权限来执行此操作。 调用时, WlanIhvControl 检索随 wlan_secure_ihv_control 对象一起存储 (DACL ) 自由访问控制列表。 如果 DACL 不包含向调用线程的访问令牌授予WLAN_WRITE_ACCESS权限的 ACE) (访问控制项,则 WlanIhvControl 将返回 ERROR_ACCESS_DENIED。 |
|
hClientHandle 为 NULL 或无效, pInterfaceGuid 为 NULL,或 pdwBytesReturned 为 NULL。 |
|
在句柄表中找不到句柄 hClientHandle 。 |
|
此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数,则将返回此值。 |
|
各种错误代码。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wlanapi.h (包括 Wlanapi.h) |
Library | Wlanapi.lib |
DLL | Wlanapi.dll |