跳轉到主要內容
使用 XBOX ID 和沙箱 ID 將使用者登入,傳回可在後續用於需要已驗證使用者之 API 呼叫的工作階段識別碼

語法

參數

serviceConfigHandle   PFServiceConfigHandle 從 PFServiceConfigCreateHandle 呼叫傳回的 PFServiceConfigHandle。 secretKey   char*
In_z
用於驗證服務要求的遊戲祕密金鑰。 request   PFAuthenticationLoginWithXboxIdRequest* 已填入的要求物件。 async   XAsyncBlock*
Inout
用於非同步作業的 XAsyncBlock。

傳回值

類型:HRESULT 此 API 作業的結果代碼。

備註

此 API 適用於 Win32、Linux 和 macOS。如果這是使用者第一次使用 XBOX ID 登入,且 CreateAccount 設定為 true,則會建立新的 PlayFab 帳戶,並連結至 XBOX Live 帳戶。在此情況下,不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶關聯。否則,如果沒有任何 PlayFab 帳戶連結至 XBOX Live 帳戶,將會傳回指出此情況的錯誤,讓遊戲可以引導使用者建立 PlayFab 帳戶。非同步工作完成時,請呼叫 PFAuthenticationServerLoginWithXboxIdGetResult 以取得結果。

需求

標頭: PFAuthentication.h

另請參閱

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