원격 연결 인증 프롬프트 표시 이벤트 처리기입니다.
구문
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*
URL에 대한 QR 코드를 PNG로 포함하는 버퍼에 대한 포인터입니다.
반환 값
설명
이 이벤트는 XUser가 사용자에게 원격 연결 인증 프로세스를 수행하라는 메시지를 표시해야 하는 경우에 발생합니다.
프롬프트 UI는 XUserPlatformRemoteConnectClosePromptEventHandler가 호출되거나 사용자가 해제할 때까지 표시되어야 합니다.
사용자가 QR 코드를 스캔할 수 없는 경우 게임에서 다시 얻은 URL과 코드를 렌더링해야 합니다. QR 코드에는 포함된 코드도 포함되지 않습니다.
모든 인수는 호출자가 소유합니다(컨텍스트 제외).
요구 사항
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Steam Deck에서 지원됨
참고 항목
XUserPlatformRemoteConnectEventHandlers
XUserPlatformRemoteConnectSetEventHandlers