Skip to main content
Get the result from a PFAuthenticationServerLoginWithXboxIdAsync call. The PFEntityHandle will always be returned, but the additional info in the PFAuthenticationLoginResult is only returned if a buffer is provided.

Syntax

Parameters

async   XAsyncBlock*
Inout
XAsyncBlock for the async operation. entityTokenResponse   PFAuthenticationEntityTokenResponse
library-allocated output
TBD bufferSize   size_t The size of the buffer for the result object. buffer   void*
*Out_writes_bytes_to(bufferSize,bufferUsed)
Byte buffer used for the Login result value and its fields. result   PFAuthenticationLoginResult
optional, library-allocated output
Pointer to the LoginResult object. bufferUsed   size_t*
optional output
The number of bytes in the provided buffer that were used.

Return value

Type: HRESULT Result code for this API operation. If the service call is unsuccessful, the result will be E_PF_EVALUATION_MODE_PLAYER_COUNT_EXCEEDED, 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 or any of the global PlayFab Service errors. See doc page “Handling PlayFab Errors” for more details on error handling.

Remarks

If the PFAuthenticationServerLoginWithXboxIdAsync call fails, entityHandle with be null. Otherwise, the handle must be closed with PFEntityCloseHandle when it is no longer needed. If returned, ‘result’ is a pointer within ‘buffer’ and does not need to be freed separately.

Requirements

Header: PFAuthentication.h

See also

PFAuthentication members
Last modified on August 3, 2026