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

# PFSegmentsServerAddPlayerTagAsync

> 지정된 태그를 플레이어 프로필에 추가합니다. 태그의 네임스페이스는 태그의 원본을 기반으로 자동 생성됩니다.

지정된 태그를 플레이어 프로필에 추가합니다. 태그의 네임스페이스는 태그의 원본을 기반으로 자동 생성됩니다.

## 구문

```cpp theme={null}
HRESULT PFSegmentsServerAddPlayerTagAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsAddPlayerTagRequest* request,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`titleEntityHandle`**   PFEntityHandle

PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 얻은 타이틀 Entity에 대한 PFEntityHandle입니다.

**`request`**   [PFSegmentsAddPlayerTagRequest\*](/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest)

값이 채워진 요청 객체입니다.

**`async`**   XAsyncBlock\*<br />*Inout*

비동기 작업을 위한 XAsyncBlock입니다.

### 반환 값

Type: HRESULT

이 API 작업의 결과 코드입니다.

## 설명

이 API는 Win32, Linux, macOS에서 사용할 수 있습니다. 이 API는 player\_tag\_added 이벤트를 트리거하고 지정된 TagName과 PlayFabID를 가진 태그를 해당 플레이어 프로필에 추가합니다. TagName은 세분화(segmentation)에 사용할 수 있으며 256자로 제한됩니다. 또한 타이틀이 가질 수 있는 태그 수에도 제한이 있습니다. ServerGetPlayerTagsAsync, ServerRemovePlayerTagAsync도 함께 참조하세요. 작업 상태를 얻으려면 XAsyncGetStatus를 호출하세요. 서비스 호출이 실패한 경우, 비동기 결과는 E\_PF\_PLAYER\_TAG\_COUNT\_LIMIT\_EXCEEDED이거나 글로벌 PlayFab 서비스 오류 중 하나가 됩니다. 오류 처리에 대한 자세한 내용은 문서 페이지 "Handling PlayFab Errors"를 참조하세요.

## 요구 사항

**헤더:** PFSegments.h

## 참고 항목

[PFSegments 멤버](/services/playfab/api-references/c/pfsegments/pfsegments_members)


## Related topics

- [Services C API 개요 - PFSegments.h](/ko/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerTagsAsync](/ko/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)
- [PFSegmentsServerRemovePlayerTagAsync](/ko/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync.md)
- [PFSegmentsServerGetPlayerTagsGetResult](/ko/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult.md)
- [PFSegmentsAddPlayerTagRequest](/ko/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)