Pular para o conteúdo principal
Obtém o resultado de uma chamada de PFAuthenticationLoginWithNintendoServiceAccountAsync. 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_INVALID_SIGNATURE, E_PF_INVALID_SIGNATURE_TIME, E_PF_NINTENDO_SWITCH_NOT_ENABLED_FOR_TITLE, E_PF_PLAYER_SECRET_ALREADY_CONFIGURED, E_PF_PLAYER_SECRET_NOT_CONFIGURED, E_PF_REQUEST_VIEW_CONSTRAINT_PARAMS_NOT_ALLOWED 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 PFAuthenticationLoginWithNintendoServiceAccountAsync 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