リモート接続認証イベント ハンドラーのプロンプトを表示します。
構文
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 に渡されたユーザー ID。
operation _In_
型: XUserPlatformOperation
この操作のハンドル。
url _In_z_
型: char const*
プロンプトに表示する URL。
code _In_z_
型: char const*
プロンプトに表示するコード。
qrCodeSize _In_
型: size_t
qrCode バッファーのサイズ。
qrCode _In_reads_bytes_
型: void const *
PNG としての URL の QR コードを含むバッファーへのポインター。
戻り値
解説
このイベントは、XUser がユーザーにリモート接続認証プロセスの実行を求める必要がある場合に発生します。
プロンプト UI は、XUserPlatformRemoteConnectClosePromptEventHandler が呼び出されるか、ユーザーによって閉じるまで表示されます。
ユーザーが QR コードをスキャンできない場合に備えて、ゲームは戻った URL とコードをレンダリングする必要があります。 QR コードには、埋め込まれたコードも含まれません。
すべての引数は、呼び出し元によって所有されます (context を除く)。
要件
ヘッダー: XUser.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Steam デッキでサポートされています
関連項目
XUserPlatformRemoteConnectEventHandlers
XUserPlatformRemoteConnectSetEventHandlers