> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserPlatformRemoteConnectShowPromptEventHandler

> XUserPlatformRemoteConnectShowPromptEventHandler

# XUserPlatformRemoteConnectShowPromptEventHandler

顯示遠端連線驗證提示的事件處理常式。

## 語法

```cpp theme={null}
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。

*code*    \_In\_z\_\
類型：char const\*

要在提示中顯示的代碼。

*qrCodeSize*    \_In\_\
類型：size\_t

qrCode 緩衝區的大小。

*qrCode*    \_In\_reads\_bytes\_\
類型：void const\*

指向緩衝區的指標，該緩衝區包含 URL 的 PNG 格式 QR 代碼。

### 傳回值

## 備註

當 XUser 需要提示使用者執行遠端連線驗證程序時，會引發此事件。

提示 UI 應持續顯示，直到呼叫 XUserPlatformRemoteConnectClosePromptEventHandler 或使用者將其關閉為止。

遊戲仍應轉譯其取回的 URL 和代碼，以防使用者無法掃描 QR 代碼。QR 代碼中也不會內嵌該代碼。

所有引數均由呼叫者擁有 (context 除外)。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

**支援的平台：** 在 Steam Deck 上支援

## 另請參閱

[`XUserPlatformRemoteConnectEventHandlers`](/zh-TW/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers)

[`XUserPlatformRemoteConnectSetEventHandlers`](/zh-TW/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers)

[`XUserPlatformRemoteConnectClosePromptEventHandler`](/zh-TW/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler)

[`XUserPlatformRemoteConnectCancelPrompt`](/zh-TW/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt)


## Related topics

- [XUserPlatformRemoteConnectShowPromptEventHandler](/ko/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler.md)
- [XUserPlatformRemoteConnectEventHandlers](/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers.md)
- [XUserPlatformRemoteConnectClosePromptEventHandler](/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler.md)