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。

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

返回代码 说明
ERROR_INVALID_PARAMETER
hClientHandleNULL 或无效,pInterfaceGuidNULL,pReserved 不为 NULL,或 ppCapabilityNULL
ERROR_INVALID_HANDLE
在句柄表中找不到句柄 hClientHandle
ERROR_NOT_SUPPORTED
此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数,则将返回此值。
RPC_STATUS
各种错误代码。

注解

调用方负责调用 WlanFreeMemory 函数以释放分配给 ppCapability 的内存。

要求

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