> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerSetEntityToken

> 設定代表實體執行程式庫動作時所使用的驗證權杖，並取代先前為該實體設定的任何權杖。

設定代表實體執行程式庫動作時應用於驗證的權杖。如果先前已為該實體設定權杖，這會取代其先前的權杖。

## 語法

```cpp theme={null}
HRESULT PFMultiplayerSetEntityToken(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* entity,  
    const char* entityToken  
)  
```

### 參數

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 執行個體的控制代碼。

**`entity`**   [PFEntityKey\*](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

要與權杖建立關聯的 PlayFab 實體索引鍵。

**`entityToken`**   char\*\
*以 null 結尾*

TBD

### 傳回值

類型：HRESULT

如果建立本機使用者成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

此方法接受 PlayFab 實體索引鍵作為 `entity`，並接受 PlayFab 實體權杖作為 `token`。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時，程式庫會查詢與該實體相關聯的權杖以用於該作業。如果先前未為該實體設定任何權杖，作業將同步失敗。在非同步作業期間，PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯，並獲授權執行該作業。如果不符合這些條件，作業將會失敗。 <br /><br /> PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出中取得，然後作為此方法的輸入提供。   <br /><br /> 提供的 `entity` 和 `token` 必須是使用傳遞給 [PFMultiplayerInitialize()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize) 的同一個 PlayFab 遊戲識別碼取得的。   <br /><br /> Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖，以用於後續需要本機使用者驗證或授權的作業，例如 `PFMultiplayerCreateAndJoinLobby`。如果提供給此呼叫的權杖已過期或因其他原因無效，需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法，以向 Multiplayer 程式庫提供新的有效權杖。   <br /><br /> 呼叫端負責監視提供給此方法之實體權杖的到期時間。當權杖接近或超過到期時間時，應執行 PlayFab 登入作業以取得新權杖，並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖達到其有效期間一半時取得新權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上，應在恢復執行後檢查權杖是否已過期。   <br /><br /> 不會對這些值執行同步驗證。

## 需求

**標頭：** PFMultiplayer.h

## 另請參閱

[PFMultiplayer 成員](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerInitialize](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize)


## Related topics

- [PFMultiplayerInitialize](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Matchmaking SDK 快速入門](/zh-TW/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Lobby SDK 快速入門](/zh-TW/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [遊戲伺服器和大廳](/zh-TW/services/playfab/multiplayer/lobby/lobby-server-overview.md)