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

> Adiciona uma determinada marca a um perfil de jogador. O namespace da marca é gerado automaticamente com base na origem da marca.

Adiciona uma determinada marca a um perfil de jogador. O namespace da marca é gerado automaticamente com base na origem da marca.

## Sintaxe

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

### Parâmetros

**`titleEntityHandle`**   PFEntityHandle

PFEntityHandle para uma Entidade de título obtida usando PFAuthenticationGetEntityWithSecretKeyAsync.

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

Objeto de solicitação preenchido.

**`async`**   XAsyncBlock\*\
*Inout*

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível no Win32, Linux e macOS. Esta API disparará um evento player\_tag\_added e adicionará uma marca com o TagName e o PlayFabID fornecidos ao perfil do jogador correspondente. TagName pode ser usado para segmentação e é limitado a 256 caracteres. Também há um limite para o número de marcas que um título pode ter. Confira também ServerGetPlayerTagsAsync, ServerRemovePlayerTagAsync. Chame XAsyncGetStatus para obter o status da operação. Se a chamada de serviço não for bem-sucedida, o resultado assíncrono será E\_PF\_PLAYER\_TAG\_COUNT\_LIMIT\_EXCEEDED ou qualquer um dos erros globais do Serviço PlayFab. Consulte a página de documentação "Handling PlayFab Errors" para obter mais detalhes sobre o tratamento de erros.

## Requisitos

**Cabeçalho:** PFSegments.h

## Confira também

[Membros de PFSegments](/pt-BR/services/playfab/api-references/c/pfsegments/pfsegments_members)


## Related topics

- [Visão geral da API C de serviços - PFSegments.h](/pt-BR/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerTagsAsync](/pt-BR/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)
- [PFSegmentsServerRemovePlayerTagAsync](/pt-BR/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync.md)
- [PFSegmentsServerGetPlayerTagsGetResult](/pt-BR/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult.md)
- [PFSegmentsAddPlayerTagRequest](/pt-BR/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)