显示“远程连接身份验证”事件处理程序的提示。
语法
typedef void (XUserPlatformRemoteConnectShowPromptEventHandler)(
_In_opt_ void* context,
_In_ uint32_t userIdentifier,
_In_ XUserPlatformOperation operation,
_In_z_ char const* url,
_In_z_ char const* code,
_In_ size_t qrCodeSize,
_In_reads_bytes_(qrCodeSize) void const* qrCode
);
参数
context _In_opt_
类型:void*
指向事件处理程序使用的数据的可选指针。
userIdentifier _In_
类型:uint32_t
添加用户时传递给 XUser 的用户标识符。
operation _In_
类型:XUserPlatformOperation
此操作的句柄。
url _In_z_
类型:char const*
要显示在提示中的 URL。
代码 _In_z_
类型:char const*
要在提示中显示的代码。
qrCodesize _In_
类型:size_t
qrCode 缓冲区的大小。
qrCode _In_reads_bytes_
类型:void const*
指向缓冲区的指针,该缓冲区包含作为 PNG 的 URL 的 QR 代码。
返回值
备注
当 XUser 需要提示用户执行远程连接身份验证过程时,将引发此事件。
应显示提示 ui,直到调用 XUserPlatformRemoteConnectClosePromptEventHandler 或用户将其关闭为止。
如果用户无法扫描 QR 码,游戏仍应呈现它返回的 URL 和代码。 QR 码也不会包含嵌入其中的代码。
所有参数都由调用方拥有(上下文除外)。
要求
头文件:XUser.h
库:xgameruntime.lib
支持的平台: Steam Deck 上支持
另请参阅
XUserPlatformRemoteConnectEventHandlers
XUserPlatformRemoteConnectSetEventHandlers