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

# 服務 C API 概觀 - PFEntity.h

> 服務 C API 概觀 - PFEntity.h

## 函式

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

## 結構

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


## Related topics

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