> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFSegmentsServerAddPlayerTagAsync

> Agrega una etiqueta determinada a un perfil de jugador. El espacio de nombres de la etiqueta se genera automáticamente en función del origen de la etiqueta.

Agrega una etiqueta determinada a un perfil de jugador. El espacio de nombres de la etiqueta se genera automáticamente en función del origen de la etiqueta.

## Sintaxis

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

### Parámetros

**`titleEntityHandle`**   PFEntityHandle

PFEntityHandle para una entidad de título obtenida mediante PFAuthenticationGetEntityWithSecretKeyAsync.

**`request`**   [PFSegmentsAddPlayerTagRequest\*](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)

Objeto de solicitud rellenado.

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

XAsyncBlock para la operación asincrónica.

### Valor devuelto

Tipo: HRESULT

Código de resultado de esta operación de API.

## Comentarios

Esta API está disponible en Win32, Linux y macOS. Esta API desencadenará un evento player\_tag\_added y agregará una etiqueta con los TagName y PlayFabID indicados al perfil de jugador correspondiente. TagName se puede usar para la segmentación y está limitado a 256 caracteres. También hay un límite en el número de etiquetas que puede tener un título. Vea también ServerGetPlayerTagsAsync, ServerRemovePlayerTagAsync. Llame a XAsyncGetStatus para obtener el estado de la operación. Si la llamada al servicio no se realiza correctamente, el resultado asincrónico será E\_PF\_PLAYER\_TAG\_COUNT\_LIMIT\_EXCEEDED o cualquiera de los errores globales de PlayFab Service. Consulte la página de documentación "Handling PlayFab Errors" para obtener más detalles sobre el control de errores.

## Requisitos

**Encabezado:** PFSegments.h

## Consulte también

[Miembros de PFSegments](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegments/pfsegments_members.md)


## Related topics

- [Información general de la API de C de Services - PFSegments.h](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerTagsAsync](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)
- [PFSegmentsServerRemovePlayerTagAsync](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync.md)
- [PFSegmentsServerGetPlayerTagsGetResult](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult.md)
- [PFSegmentsAddPlayerTagRequest](https://docs.xbox.com/es/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)