wlanapi.h (wlanGetInterfaceCapability 函数)
WlanGetInterfaceCapability 函数检索接口的功能。
语法
DWORD WlanGetInterfaceCapability(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
PVOID pReserved,
[out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);
参数
[in] hClientHandle
客户端的会话句柄,由上一次对 WlanOpenHandle 函数的调用获取。
[in] pInterfaceGuid
此接口的 GUID。
pReserved
保留供将来使用。 必须设置为 NULL。
[out] ppCapability
一个 WLAN_INTERFACE_CAPABILITY 结构,包含有关指定接口的功能的信息。
返回值
如果函数成功,则返回值为 ERROR_SUCCESS。
如果函数失败,则返回值可能是以下返回代码之一。
返回代码 | 说明 |
---|---|
|
hClientHandle 为 NULL 或无效,pInterfaceGuid 为 NULL,pReserved 不为 NULL,或 ppCapability 为 NULL。 |
|
在句柄表中找不到句柄 hClientHandle 。 |
|
此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数,则将返回此值。 |
|
各种错误代码。 |
注解
调用方负责调用 WlanFreeMemory 函数以释放分配给 ppCapability 的内存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wlanapi.h (包括 Wlanapi.h) |
Library | Wlanapi.lib |
DLL | Wlanapi.dll |