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

# Services C API overview - PFEntity.h

> Services C API overview - PFEntity.h

## 函数

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

## 结构

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


## Related topics

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