PFSegmentsServerAddPlayerTagAsync - XBOX Game Development Documentation

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

구문

HRESULT PFSegmentsServerAddPlayerTagAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsAddPlayerTagRequest* request,  
    XAsyncBlock* async  
)  

매개 변수

titleEntityHandle PFEntityHandle PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 얻은 타이틀 Entity에 대한 PFEntityHandle입니다. request PFSegmentsAddPlayerTagRequest* 값이 채워진 요청 객체입니다. async XAsyncBlock*
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 멤버

​구문

​매개 변수

​반환 값

​설명

​요구 사항

​참고 항목

구문

매개 변수

반환 값

설명

요구 사항

참고 항목