> ## 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

Manipulador de eventos de exibição do prompt de autenticação de conexão remota.

## Sintaxe

```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
);
```

### Parâmetros

*context*    \_In\_opt\_\
Tipo: void\*

Ponteiro opcional para dados usados pelo manipulador de eventos.

*userIdentifier*    \_In\_\
Tipo: uint32\_t

O identificador de usuário que foi passado ao XUser quando o usuário foi adicionado.

*operation*   \_In\_\
Tipo: XUserPlatformOperation

O identificador desta operação.

*url*    \_In\_z\_\
Tipo: char const\*

A URL a ser exibida no prompt.

*code*    \_In\_z\_\
Tipo: char const\*

O código a ser exibido no prompt.

*qrCodeSize*    \_In\_\
Tipo: size\_t

Tamanho do buffer qrCode.

*qrCode*    \_In\_reads\_bytes\_\
Tipo: void const\*

Um ponteiro para um buffer que contém o código QR da URL como PNG.

### Valor retornado

## Comentários

Este evento é gerado quando o XUser precisa solicitar que o usuário execute o processo de autenticação de conexão remota.

A interface do usuário do prompt deve ser exibida até que XUserPlatformRemoteConnectClosePromptEventHandler seja chamado ou que ela seja descartada pelo usuário.

O jogo ainda deve renderizar a URL e o código recebidos caso o usuário não consiga ler o código QR. O código QR também não conterá o código incorporado nele.

Todos os argumentos pertencem ao chamador (exceto context).

## Requisitos

**Cabeçalho:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** com suporte no Steam Deck

## Confira também

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

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

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

[`XUserPlatformRemoteConnectCancelPrompt`](/pt-BR/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)
