> ## 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.

# 服務 C API 概觀 - PFEntity.h

> 服務 C API 概觀 - PFEntity.h

## 函式

| 函式 | 描述 |
| - | - |
| [PFEntityCloseHandle](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityclosehandle) | 關閉 PFEntityHandle。 |
| [PFEntityDuplicateHandle](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityduplicatehandle) | 複製 PFEntityHandle。 |
| [PFEntityGetAPIEndpoint](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetapiendpoint) | 取得與實體控制代碼相關聯之 PFServiceConfig 的 API 端點。 |
| [PFEntityGetAPIEndpointSize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetapiendpointsize) | 取得保存實體控制代碼之 API 端點字串所需的緩衝區大小。 |
| [PFEntityGetEntityKey](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykey) | 取得實體的 PFEntityKey。 |
| [PFEntityGetEntityKeySize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykeysize) | 取得儲存實體之 PFEntityKey 所需的大小 (以位元組為單位)。 |
| [PFEntityGetEntityTokenAsync](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenasync) | 取得實體快取的 PFEntityToken。 |
| [PFEntityGetEntityTokenResult](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenresult) | 取得成功之 PFEntityGetEntityTokenAsync 呼叫的結果。 |
| [PFEntityGetEntityTokenResultSize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenresultsize) | 取得儲存 PFEntityGetEntityTokenAsync 呼叫結果所需的大小 (以位元組為單位)。 |
| [PFEntityGetSecretKey](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetsecretkey) | 取得與遊戲實體相關聯的 PlayFab secretKey。如果沒有與所提供實體相關聯的祕密金鑰，將會失敗並傳回 E\_PF\_NOSECRETKEY。 |
| [PFEntityGetSecretKeySize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetsecretkeysize) | 取得保存 PlayFab secretKey 所需的緩衝區大小。如果沒有與所提供實體相關聯的祕密金鑰，將會失敗並傳回 E\_PF\_NOSECRETKEY。 |
| [PFEntityGetTitleId](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygettitleid) | 取得與實體控制代碼相關聯之 PFServiceConfig 的 titleId。 |
| [PFEntityGetTitleIdSize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygettitleidsize) | 取得保存實體控制代碼之 titleId 字串所需的緩衝區大小。 |
| [PFEntityIsTitlePlayer](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityistitleplayer) | 用於檢查實體是否為遊戲玩家 (Title Player) 的便利方法。這相當於呼叫 PFEntityGetEntityKey 並將 entityKey.type 與 PFTitlePlayerEntityType 比較。 |
| [PFEntityRegisterTokenExpiredEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityregistertokenexpiredeventhandler) | 註冊 EntityToken 到期事件的處理常式。 |
| [PFEntityRegisterTokenRefreshedEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityregistertokenrefreshedeventhandler) | 註冊 EntityToken 重新整理事件的處理常式。 |
| [PFEntityTokenExpiredEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitytokenexpiredeventhandler) | EntityToken 到期事件處理常式。在 SDK 無法自動重新整理快取之 EntityToken 的情況下，需要用來重新驗證玩家。 |
| [PFEntityTokenRefreshedEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitytokenrefreshedeventhandler) | 每次實體自動重新驗證並因而取得新的 EntityToken 時所叫用的處理常式。實體將會在其 EntityToken 到期之前自動重新驗證。 |
| [PFEntityUnregisterTokenExpiredEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityunregistertokenexpiredeventhandler) | 取消註冊先前註冊的回呼。 |
| [PFEntityUnregisterTokenRefreshedEventHandler](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentityunregistertokenrefreshedeventhandler) | 取消註冊先前註冊的 PFEntityTokenRefreshedCallback。 |

## 結構

| 結構 | 說明 |
| - | - |
| [PFEntityToken](/zh-TW/services/playfab/api-references/c/pfentity/structs/pfentitytoken) | PlayFab EntityToken 及其到期時間。用於驗證 PlayFab 服務呼叫。 |


## Related topics

- [PFEntityGetEntityKey](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykey.md)
- [PFEntityToken](/zh-TW/services/playfab/api-references/c/pfentity/structs/pfentitytoken.md)
- [PFEntityGetEntityTokenAsync](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenasync.md)
- [PFEntityGetEntityKeySize](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykeysize.md)
- [PFEntityGetEntityTokenResult](/zh-TW/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenresult.md)