> ## 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에 대한 QR 코드를 PNG로 포함하는 버퍼에 대한 포인터입니다.

### 반환값

## 설명

이 이벤트는 XUser가 사용자에게 원격 연결 인증 프로세스를 수행하도록 프롬프트해야 할 때 발생합니다.

프롬프트 UI는 XUserPlatformRemoteConnectClosePromptEventHandler가 호출되거나 사용자가 닫을 때까지 표시되어야 합니다.

사용자가 QR 코드를 스캔할 수 없는 경우를 대비하여 게임은 여전히 반환된 URL과 코드를 렌더링해야 합니다. 또한 QR 코드에는 코드가 포함되어 있지 않습니다.

모든 인수는 호출자가 소유합니다(context 제외).

## 요구 사항

**헤더:** XUser.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Steam Deck에서 지원됨

## 함께 보기

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

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

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

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


## Related topics

- [XUserPlatformRemoteConnectClosePromptEventHandler](/ko/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler.md)
- [XUserPlatformRemoteConnectEventHandlers](/ko/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers.md)
- [XUserPlatformRemoteConnectCancelPrompt](/ko/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt.md)
- [XUserPlatformRemoteConnectSetEventHandlers](/ko/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers.md)
- [XUserPlatformOperationResult](/ko/reference/system/xuser/enums/XUserPlatformOperationResult.md)