Pular para o conteúdo principal
Obtém o resultado de uma chamada PFAuthenticationServerLoginWithXboxAsync. 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. entityTokenResponse   PFAuthenticationEntityTokenResponse**
saída alocada pela biblioteca
A definir bufferSize   size_t O tamanho do buffer para o objeto de resultado. buffer   void*
*Out_writes_bytes_to(bufferSize,bufferUsed)
Buffer de bytes usado para o valor de resultado de Login e seus campos. result   PFAuthenticationLoginResult**
saída opcional alocada pela biblioteca
Ponteiro para o objeto LoginResult. bufferUsed   size_t*
saída opcional
O número de bytes usados no buffer fornecido.

Valor de retorno

Tipo: HRESULT Código de resultado desta operação de API. Se a chamada de serviço não for bem-sucedida, o resultado será 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_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 PFAuthenticationServerLoginWithXboxAsync 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