Passer au contenu principal
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

​
Paramètres

titleEntityHandle   PFEntityHandle PFEntityHandle pour une entité de titre obtenue à l’aide de PFAuthenticationGetEntityWithSecretKeyAsync. request   PFSegmentsAddPlayerTagRequest* Objet de requête renseigné. async   XAsyncBlock*
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. Le nombre de balises qu’un titre peut avoir est également limité. Voir aussi ServerGetPlayerTagsAsync, ServerRemovePlayerTagAsync. Appelez XAsyncGetStatus pour obtenir l’état de l’opération. Si l’appel au 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
Dernière modification le 6 octobre 2026