> ## 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 개요 - PFEntity.h

> Services C API 개요 - 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를 가져옵니다. 제공된 엔터티와 연결된 비밀 키가 없으면 E\_PF\_NOSECRETKEY로 실패합니다.                             |
| [PFEntityGetSecretKeySize](/services/playfab/api-references/c/pfentity/functions/pfentitygetsecretkeysize)                                         | PlayFab secretKey를 저장하는 데 필요한 버퍼의 크기를 가져옵니다. 제공된 엔터티와 연결된 비밀 키가 없으면 E\_PF\_NOSECRETKEY로 실패합니다.                       |
| [PFEntityIsTitlePlayer](/services/playfab/api-references/c/pfentity/functions/pfentityistitleplayer)                                               | 엔터티가 타이틀 플레이어인지 확인하는 편의 메서드입니다. 이는 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 서비스 호출을 인증하는 데 사용됩니다. |