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

# PFAuthenticationLoginWithXUserAsync

> Conecta o usuário usando um XUserHandle, retornando um identificador de sessão que pode ser usado posteriormente para chamadas de API que exigem um usuário autenticado

Conecta o usuário usando um XUserHandle, retornando um identificador de sessão que pode ser usado posteriormente para chamadas de API que exigem um usuário autenticado

## Sintaxe

```cpp theme={null}
HRESULT PFAuthenticationLoginWithXUserAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const PFAuthenticationLoginWithXUserRequest* request,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigHandle retornado da chamada de PFServiceConfigCreateHandle.

**`request`**   [PFAuthenticationLoginWithXUserRequest\*](/pt-BR/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxuserrequest)

Objeto de solicitação preenchido.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock para a operação assíncrona.

### Valor retornado

Tipo: HRESULT

Código de resultado para esta operação de API.

## Comentários

Esta API está disponível no GDK. Se esta for a primeira vez que um usuário entra com a conta do XBOX Live e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do XBOX Live. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do XBOX Live, será retornado um erro indicando isso, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Consulte também ClientLinkXboxAccountAsync, ClientUnlinkXboxAccountAsync. Quando a tarefa assíncrona for concluída, chame [PFAuthenticationLoginWithXUserGetResult](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxusergetresult) para obter o resultado.

## Requisitos

**Cabeçalho:** PFAuthentication\_Xbox.h

## Confira também

[Membros de PFAuthentication\_Xbox](/pt-BR/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [PFAuthenticationLoginWithXUserGetResultSize](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxusergetresultsize.md)
- [PFAuthenticationLoginWithXUserGetResult](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxusergetresult.md)
- [PFAuthenticationLoginWithXboxAsync](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxboxasync.md)
- [PFAuthenticationLoginWithXUserRequest](/pt-BR/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxuserrequest.md)
- [Início rápido (Windows) - Configuração do SDK Core](/pt-BR/services/playfab/sdks/unified-sdk/quickstart-core.md)