跳轉到主要內容
使用遊戲產生的自訂唯一識別碼登入使用者,並傳回工作階段識別碼,之後可用於需要已驗證使用者的 API 呼叫

語法

參數

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

傳回值

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

備註

此 API 適用於 Windows。強烈建議開發人員確保客戶極不可能產生已被其他客戶使用的識別碼。如果這是使用者第一次使用該自訂識別碼登入,且 CreateAccount 設定為 true,則會建立新的 PlayFab 帳戶並連結至該自訂識別碼。在此情況下,PlayFab 帳戶不會與任何電子郵件或使用者名稱相關聯。否則,如果沒有任何 PlayFab 帳戶連結至該自訂識別碼,將會傳回指出此情況的錯誤,讓遊戲可以引導使用者建立 PlayFab 帳戶。非同步工作完成時,請呼叫 PFAuthenticationServerLoginWithCustomIDGetResult 以取得結果。

需求

標頭: PFAuthentication.h

另請參閱

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