語法
參數
handle PFMultiplayerHandle
PFMultiplayer API 執行個體的控制代碼。
entity PFEntityKey*
要與權杖建立關聯的 PlayFab 實體索引鍵。
entityToken char*以 null 結尾 TBD
傳回值
類型：HRESULT 如果建立本機使用者成功，則為S_OK；否則為錯誤碼。可透過 PFMultiplayerGetErrorMessage() 擷取錯誤碼的人類可讀形式。
備註
此方法接受 PlayFab 實體索引鍵作為entity，並接受 PlayFab 實體權杖作為 token。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時，程式庫會查詢與該實體相關聯的權杖以用於該作業。如果先前未為該實體設定任何權杖，作業將同步失敗。在非同步作業期間，PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯，並獲授權執行該作業。如果不符合這些條件，作業將會失敗。 PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出中取得，然後作為此方法的輸入提供。
提供的
entity 和 token 必須是使用傳遞給 PFMultiplayerInitialize() 的同一個 PlayFab 遊戲識別碼取得的。 Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖，以用於後續需要本機使用者驗證或授權的作業，例如
PFMultiplayerCreateAndJoinLobby。如果提供給此呼叫的權杖已過期或因其他原因無效，需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法，以向 Multiplayer 程式庫提供新的有效權杖。 呼叫端負責監視提供給此方法之實體權杖的到期時間。當權杖接近或超過到期時間時，應執行 PlayFab 登入作業以取得新權杖，並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖達到其有效期間一半時取得新權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上，應在恢復執行後檢查權杖是否已過期。
不會對這些值執行同步驗證。
需求
標頭： PFMultiplayer.h另請參閱
PFMultiplayer 成員PFMultiplayerInitialize