XUserPlatformRemoteConnectShowPromptEventHandler

显示“远程连接身份验证”事件处理程序的提示。

语法

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

XUserPlatformRemoteConnectClosePromptEventHandler

XUserPlatformRemoteConnectCancelPrompt