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

# Services C API overview - PFEntity.h

> Services C API overview - PFEntity.h

## 函数

| 函数 | 说明 |
| - | - |
| [PFEntityCloseHandle](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityclosehandle.md) | 关闭 PFEntityHandle。 |
| [PFEntityDuplicateHandle](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityduplicatehandle.md) | 复制 PFEntityHandle。 |
| [PFEntityGetAPIEndpoint](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetapiendpoint.md) | 获取与实体句柄关联的 PFServiceConfig 的 API 终结点。 |
| [PFEntityGetAPIEndpointSize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetapiendpointsize.md) | 获取实体句柄中用于保存 API 终结点字符串所需的缓冲区大小。 |
| [PFEntityGetEntityKey](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykey.md) | 获取实体的 PFEntityKey。 |
| [PFEntityGetEntityKeySize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetentitykeysize.md) | 获取存储实体的 PFEntityKey 所需的字节大小。 |
| [PFEntityGetEntityTokenAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenasync.md) | 获取实体的缓存 PFEntityToken。 |
| [PFEntityGetEntityTokenResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenresult.md) | 获取成功的 PFEntityGetEntityTokenAsync 调用的结果。 |
| [PFEntityGetEntityTokenResultSize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetentitytokenresultsize.md) | 获取存储 PFEntityGetEntityTokenAsync 调用结果所需的字节大小。 |
| [PFEntityGetSecretKey](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetsecretkey.md) | 获取与标题实体关联的 PlayFab secretKey。如果所提供实体没有关联的 Secret Key，则失败并返回 E\_PF\_NOSECRETKEY。 |
| [PFEntityGetSecretKeySize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitygetsecretkeysize.md) | 获取用于保存 PlayFab secretKey 所需的缓冲区大小。如果所提供实体没有关联的 Secret Key，则失败并返回 E\_PF\_NOSECRETKEY。 |
| [PFEntityIsTitlePlayer](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityistitleplayer.md) | 用于检查实体是否为 Title Player 的便捷方法。等效于调用 PFEntityGetEntityKey 并将 entityKey.type 与 PFTitlePlayerEntityType 进行比较。 |
| [PFEntityRegisterTokenExpiredEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityregistertokenexpiredeventhandler.md) | 为 EntityToken 过期事件注册处理程序。 |
| [PFEntityRegisterTokenRefreshedEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityregistertokenrefreshedeventhandler.md) | 为 EntityToken 刷新事件注册处理程序。 |
| [PFEntityTokenExpiredEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitytokenexpiredeventhandler.md) | EntityToken 过期事件处理程序。在 SDK 无法自动刷新已缓存的 EntityToken 的情况下，用于对玩家进行重新身份验证。 |
| [PFEntityTokenRefreshedEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentitytokenrefreshedeventhandler.md) | 每次实体被自动重新进行身份验证并因此获得新的 EntityToken 时调用的处理程序。实体将在其 EntityToken 过期前自动重新进行身份验证。 |
| [PFEntityUnregisterTokenExpiredEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityunregistertokenexpiredeventhandler.md) | 注销先前注册的回调。 |
| [PFEntityUnregisterTokenRefreshedEventHandler](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/functions/pfentityunregistertokenrefreshedeventhandler.md) | 注销先前注册的 PFEntityTokenRefreshedCallback。 |

## 结构

| 结构 | 说明 |
| - | - |
| [PFEntityToken](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfentity/structs/pfentitytoken.md) | PlayFab EntityToken 及其到期时间。用于对 PlayFab 服务调用进行身份验证。 |


## Related topics

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