跳轉到主要內容
取得 PFAuthenticationServerLoginWithXboxIdAsync 呼叫的結果。一律會傳回 PFEntityHandle,但只有在提供緩衝區時,才會傳回 PFAuthenticationLoginResult 中的其他資訊。

語法

參數

async   XAsyncBlock*
Inout
用於非同步作業的 XAsyncBlock。 entityTokenResponse   PFAuthenticationEntityTokenResponse**
library-allocated output
TBD bufferSize   size_t 結果物件的緩衝區大小。 buffer   void*
*Out_writes_bytes_to(bufferSize,bufferUsed)
用於 Login 結果值及其欄位的位元組緩衝區。 result   PFAuthenticationLoginResult**
optional, library-allocated output
LoginResult 物件的指標。 bufferUsed   size_t*
optional output
所提供緩衝區中已使用的位元組數。

傳回值

類型:HRESULT 此 API 作業的結果代碼。如果服務呼叫失敗,結果將為 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 或任何全域 PlayFab 服務錯誤。如需錯誤處理的詳細資訊,請參閱文件頁面「Handling PlayFab Errors」。

備註

如果 PFAuthenticationServerLoginWithXboxIdAsync 呼叫失敗,entityHandle 將為 null。否則,當不再需要該控制代碼時,必須使用 PFEntityCloseHandle 將其關閉。如果有傳回,‘result’ 是 ‘buffer’ 內的指標,不需要另外釋放。

需求

標頭: PFAuthentication.h

另請參閱

PFAuthentication 成員
最後修改於 2026年10月6日