(wlanapi.h) WFD_OPEN_SESSION_COMPLETE_CALLBACK 回调函数

WFD_OPEN_SESSION_COMPLETE_CALLBACK函数定义 WFDStartOpenSession 操作完成时由 WFDStartOpenSession 函数调用的回调函数。

语法

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

参数

[in] hSessionHandle

Wi-Fi Direct 会话的会话句柄。 这是 WFDStartOpenSession 函数先前返回的会话句柄。

[in] pvContext

WFDStartOpenSession 函数传递到回调函数的上下文指针。

[in] guidSessionInterface

此 Wi-Fi Direct 设备具有打开会话的本地网络接口的接口 GUID。 如果高层协议需要确定 Wi-Fi Direct 会话绑定到的网络接口,此参数非常有用。 仅当 dwError 参数ERROR_SUCCESS时,才会返回此值。

[in] dwError

一个 值,该值指定在调用 WFDStartOpenSession 函数期间是否遇到错误。 如果此值ERROR_SUCCESS,则未发生任何错误,并且打开会话的操作已成功完成。

可能使用以下其他值:

含义
ERROR_INVALID_PARAMETER
参数不正确。 如果 hClientHandle 参数为 NULL 或无效,则返回此错误。
ERROR_INVALID_STATE
组或资源的状态不正确,无法执行请求的操作。 如果域上的组策略禁用了 Wi-Fi Direct 服务,则返回此错误。
ERROR_SERVICE_NOT_ACTIVE
该服务尚未启动。 如果 WLAN 自动配置服务未运行,则返回此错误。
RPC_STATUS
各种 RPC 和其他错误代码。 使用 FormatMessage 获取返回错误的消息字符串。

[in] dwReasonCode

一个 值,该值指定 在 WFDStartOpenSession 期间发生错误时的更多详细信息。

返回值

备注

WFD_OPEN_SESSION_COMPLETE_CALLBACK函数是 Wi-Fi Direct 的一部分,这是 Windows 8 和 Windows Server 2012 中的一项新功能。 Wi-Fi Direct 基于由 Wi-Fi Alliance 开发的 Wi-Fi 对等技术规范 v1.1 (请参阅 Wi-Fi 联盟发布的规范) 。 Wi-Fi 对等技术规范的目标是为 Wi-Fi 设备到设备连接提供解决方案,而无需使用无线接入点 (无线 AP) 来设置连接或使用现有的 Wi-Fi adhoc (IBSS) 机制。

WFDStartOpenSession 函数启动异步操作,以启动与特定 Wi-Fi Direct 设备的按需连接。 目标 Wi-Fi 设备之前必须已通过 Windows 配对体验进行配对。 完成进行 Wi-FI Direct 连接的异步操作时,将调用 pfnCallback 参数中指定的回调函数。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h

另请参阅

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDStartOpenSession

WFD_OPEN_SESSION_COMPLETE_CALLBACK