wlanOpenHandle 函数 (wlanapi.h)

  • 项目

WlanOpenHandle 函数会打开与服务器的连接。

语法

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

参数

[in] dwClientVersion

客户端支持的 WLAN API 的最高版本。

Value 含义
1
 具有 SP3 的 Windows XP 的客户端版本和具有 SP2 的 Windows XP 的无线 LAN API。
2
 适用于 Windows Vista 和 Windows Server 2008 的客户端版本

pReserved

保留供将来使用。 必须设置为 NULL。

[out] pdwNegotiatedVersion

将在此会话中使用的 WLAN API 的版本。 此值通常是客户端和服务器都支持的最高版本。

[out] phClientHandle

客户端在此会话中使用的句柄。 此句柄在整个会话中由其他函数使用。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
 pdwNegotiatedVersion 为 NULL， phClientHandle 为 NULL，或 pReserved 不为 NULL。
ERROR_NOT_ENOUGH_MEMORY
 未能分配内存来创建客户端上下文。
RPC_STATUS
 各种错误代码。
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 服务器发出的句柄过多。

注解

由 dwClientVersion 和 pdwNegotiatedVersion 指定的版本号是一个复合版本号，由主要版本和次要版本组成。 主版本由低序字指定，次要版本由高序字指定。 宏 WLAN_API_VERSION_MAJOR(_v) 和 WLAN_API_VERSION_MINOR(_v) 分别返回主版本号和次要版本号。 可以使用宏 WLAN_API_MAKE_VERSION(_major, _minor)构造版本号。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API：如果无线零配置 (WZC) 服务尚未启动或 WZC 服务没有响应，WlanOpenHandle 将返回错误消息。

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll
可再发行组件 适用于 Windows XP 的无线 LAN API SP2

另请参阅

WlanCloseHandle