Pular para o conteúdo principal
Obtém o resultado de uma chamada de PFAuthenticationLoginWithXboxAsync. O PFEntityHandle sempre será retornado, mas as informações adicionais em PFAuthenticationLoginResult só serão retornadas se um buffer for fornecido.

Sintaxe

Parâmetros

async   XAsyncBlock*
Inout
XAsyncBlock para a operação assíncrona. entityHandle   PFEntityHandle*
output
PFEntityHandle que pode ser usado para autenticar outras chamadas de API do PlayFab. bufferSize   size_t O tamanho do buffer para o objeto de resultado. buffer   void*
*Out_writes_bytes_to_opt(bufferSize,bufferUsed)
Buffer de bytes usado para o valor do resultado de Login e seus campos. result   PFAuthenticationLoginResult**
optional, library-allocated output
Ponteiro para o objeto LoginResult. bufferUsed   size_t*
optional output
O número de bytes usados no buffer fornecido.

Valor retornado

Tipo: HRESULT Código de resultado para esta operação de API. Se a chamada de serviço não for bem-sucedida, o resultado será E_PF_ENCRYPTION_KEY_MISSING, E_PF_EVALUATION_MODE_PLAYER_COUNT_EXCEEDED, E_PF_EXPIRED_XBOX_LIVE_TOKEN, E_PF_INVALID_XBOX_LIVE_TOKEN, E_PF_REQUEST_VIEW_CONSTRAINT_PARAMS_NOT_ALLOWED, E_PF_SIGNED_REQUEST_NOT_ALLOWED, E_PF_XBOX_INACCESSIBLE, E_PF_XBOX_REJECTED_XSTS_EXCHANGE_REQUEST, E_PF_XBOX_XASS_EXCHANGE_FAILURE ou qualquer um dos erros globais do serviço PlayFab. Consulte a página de documentação “Handling PlayFab Errors” para obter mais detalhes sobre o tratamento de erros.

Comentários

Se a chamada de PFAuthenticationLoginWithXboxAsync falhar, entityHandle será nulo. Caso contrário, o identificador deverá ser fechado com PFEntityCloseHandle quando não for mais necessário. Se retornado, ‘result’ é um ponteiro dentro de ‘buffer’ e não precisa ser liberado separadamente.

Requisitos

Cabeçalho: PFAuthentication.h

Confira também

Membros de PFAuthentication
Última modificação em 6 de outubro de 2026