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

# PFAuthenticationServerLoginWithCustomIDAsync

> Conecta o usuário usando um identificador exclusivo personalizado gerado pelo título, retornando um identificador de sessão que pode ser usado posteriormente em chamadas de API que exigem um usuário autenticado

Conecta o usuário usando um identificador exclusivo personalizado gerado pelo título, retornando um identificador de sessão que pode ser usado posteriormente em chamadas de API que exigem um usuário autenticado

## Sintaxe

```cpp theme={null}
HRESULT PFAuthenticationServerLoginWithCustomIDAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationServerLoginWithCustomIDRequest* request,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigHandle retornado pela chamada PFServiceConfigCreateHandle.

**`secretKey`**   char\*<br />*In\_z*

Chave secreta do título usada para autenticar a solicitação de serviço.

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

Objeto de solicitação preenchido.

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

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível no Windows. É altamente recomendável que os desenvolvedores garantam que seja extremamente improvável que um cliente consiga gerar uma ID que já esteja em uso por outro cliente. Se esta for a primeira vez que um usuário entra com a ID personalizada e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à ID personalizada. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à ID personalizada, será retornado um erro indicando isso, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Quando a tarefa assíncrona for concluída, chame [PFAuthenticationServerLoginWithCustomIDGetResult](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithcustomidgetresult) para obter o resultado.

## Requisitos

**Cabeçalho:** PFAuthentication.h

## Confira também

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


## Related topics

- [PFAuthenticationServerLoginWithCustomIDGetResultSize](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithcustomidgetresultsize.md)
- [PFAuthenticationServerLoginWithCustomIDGetResult](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithcustomidgetresult.md)
- [Visão geral da API C do Services - PFAuthentication.h](/pt-BR/services/playfab/api-references/c/pfauthentication/pfauthentication_members.md)
- [PFAuthenticationServerLoginWithServerCustomIdAsync](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithservercustomidasync.md)
- [PFAuthenticationServerLoginWithServerCustomIdGetResult](/pt-BR/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithservercustomidgetresult.md)