(wlanapi.h) WFD_OPEN_SESSION_COMPLETE_CALLBACK 回调函数

项目
12/22/2023

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