(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,则未发生任何错误,并且打开会话的操作已成功完成。
可能使用以下其他值:
[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 |