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

# PartyLocalUser::UpdateEntityToken

> 향후 인증된 작업에 사용하기 위해 이 로컬 사용자와 연결된 PlayFab Entity Token을 업데이트합니다.

향후 인증된 작업에 사용하기 위해 이 로컬 사용자와 연결된 PlayFab Entity Token을 업데이트합니다.

## Syntax

```cpp theme={null}
PartyError UpdateEntityToken(  
    PartyString entityToken  
)  
```

### Parameters

**`entityToken`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

로컬 사용자와 연결할 새 PlayFab Entity Token입니다.

### Return value

PartyError

호출이 성공한 경우 `c_partyErrorSuccess`, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 검색할 수 있습니다.

## Remarks

이 메서드는 PlayFab Entity Token을 `entityToken`으로 받습니다. 이 값에 대해 동기 유효성 검사가 수행되지 않습니다. 라이브러리가 네트워크 생성, 네트워크 인증 또는 음성-텍스트 변환 전사 수행과 같이 사용자 인증 또는 권한 부여가 필요한 작업을 수행할 때, Party 서비스는 토큰이 유효하고 만료되지 않았으며 [PartyManager::CreateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser) 또는 [PartyManager::CreateLocalUserWithEntityType()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype) 호출에 제공된 것과 동일한 Entity ID와 연결되어 있으며 작업 수행 권한이 있는지 유효성을 검사합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다. <br /><br /> PlayFab Entity Token은 PlayFab 로그인 작업의 출력에서 얻을 수 있으며 이 메서드에 대한 입력으로 제공될 수 있습니다. 토큰은 원래 [PartyManager::CreateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser) 또는 [PartyManager::CreateLocalUserWithEntityType()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)에 지정된 동일한 PlayFab Entity ID 및 유형과 연결되어 있어야 합니다.   <br /><br /> 제공된 `entityToken`은 [PartyManager::Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)에 전달된 것과 동일한 Title ID를 사용하여 획득한 것이어야 합니다.   <br /><br /> Party 라이브러리는 [PartyManager::CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) 또는 [PartyNetwork::AuthenticateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser)와 같이 로컬 사용자에 대한 인증 또는 권한 부여가 필요한 후속 작업에서 사용하기 위해 제공된 PlayFab Entity Token의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우, 유효한 토큰이 필요한 작업은 실패합니다. 이 메서드를 다시 호출하여 새 유효 토큰을 Party 라이브러리에 제공할 수 있습니다.   <br /><br /> 이 메서드와 [PartyManager::CreateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser) 또는 [PartyManager::CreateLocalUserWithEntityType()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)에 제공된 엔터티 토큰의 만료를 모니터링하는 것은 호출자의 책임입니다. 토큰이 만료 시간에 가까워지거나 만료된 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 이 메서드를 호출하여 Party 라이브러리에 제공해야 합니다. 이전에 제공된 토큰이 유효 기간의 절반을 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태로 들어가거나 애플리케이션 실행을 오랫동안 일시 중지시켜 토큰이 만료되기 전에 새로 고쳐지지 않을 수 있는 플랫폼에서는 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.

## Requirements

**Header:** Party.h

## See also

[PartyLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)\
[PartyManager::GetErrorMessage](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)\
[PartyManager::CreateLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser)\
[PartyManager::CreateLocalUserWithEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyNetwork::AuthenticateLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser)


## Related topics

- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::CreateLocalUserWithEntityType](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::CreateLocalUser](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PartyManager::Initialize](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyNetwork::AuthenticateLocalUser](/ko/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md)