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

> Ajoute une balise donnée à un profil de joueur. L'espace de noms de la balise est généré automatiquement en fonction de la source de la balise.

Ajoute une balise donnée à un profil de joueur. L'espace de noms de la balise est généré automatiquement en fonction de la source de la balise.

## Syntaxe

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

### Paramètres

**`titleEntityHandle`**   PFEntityHandle

PFEntityHandle pour une entité de titre obtenue à l'aide de PFAuthenticationGetEntityWithSecretKeyAsync.

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

Objet de requête renseigné.

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

XAsyncBlock pour l'opération asynchrone.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API.

## Notes

Cette API est disponible sur Win32, Linux et macOS. Cette API déclenche un événement player\_tag\_added et ajoute une balise avec les TagName et PlayFabID donnés au profil de joueur correspondant. TagName peut être utilisé pour la segmentation et est limité à 256 caractères. De plus, le nombre de balises qu'un titre peut avoir est limité. Voir aussi ServerGetPlayerTagsAsync, ServerRemovePlayerTagAsync. Appelez XAsyncGetStatus pour obtenir l'état de l'opération. Si l'appel de service échoue, le résultat asynchrone sera E\_PF\_PLAYER\_TAG\_COUNT\_LIMIT\_EXCEEDED ou l'une des erreurs globales du service PlayFab. Consultez la page de documentation « Handling PlayFab Errors » pour plus de détails sur la gestion des erreurs.

## Configuration requise

**En-tête :** PFSegments.h

## Voir aussi

[Membres de PFSegments](/fr-CA/services/playfab/api-references/c/pfsegments/pfsegments_members)


## Related topics

- [Vue d'ensemble de l'API C Services - PFSegments.h](/fr-CA/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerTagsAsync](/fr-CA/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)
- [PFSegmentsServerRemovePlayerTagAsync](/fr-CA/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync.md)
- [PFSegmentsServerGetPlayerTagsGetResult](/fr-CA/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult.md)
- [PFSegmentsAddPlayerTagRequest](/fr-CA/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)