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

> 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\*](/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest)

Objeto de solicitud rellenado.

**`async`**   XAsyncBlock\*<br />*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](/services/playfab/api-references/c/pfsegments/pfsegments_members)