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

> 指定されたタグをプレイヤー プロファイルに追加します。タグの名前空間は、タグのソースに基づいて自動的に生成されます。

指定されたタグをプレイヤー プロファイルに追加します。タグの名前空間は、タグのソースに基づいて自動的に生成されます。

## 構文

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

### パラメーター

**`titleEntityHandle`**   PFEntityHandle

PFAuthenticationGetEntityWithSecretKeyAsync を使用して取得したタイトル エンティティの PFEntityHandle。

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

値が設定されたリクエスト オブジェクト。

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API は Win32、Linux、macOS で利用できます。この API は player\_tag\_added イベントをトリガーし、指定した TagName と PlayFabID を持つタグを対応するプレイヤー プロファイルに追加します。TagName はセグメンテーションに使用でき、256 文字までに制限されています。また、タイトルが保持できるタグの数にも制限があります。ServerGetPlayerTagsAsync、ServerRemovePlayerTagAsync も参照してください。XAsyncGetStatus を呼び出して操作のステータスを取得してください。サービス呼び出しが失敗した場合、非同期の結果は E\_PF\_PLAYER\_TAG\_COUNT\_LIMIT\_EXCEEDED またはグローバルな PlayFab サービス エラーのいずれかになります。エラー処理の詳細については、ドキュメント ページ「Handling PlayFab Errors」を参照してください。

## 要件

**ヘッダー:** PFSegments.h

## 関連項目

[PFSegments のメンバー](/services/playfab/api-references/c/pfsegments/pfsegments_members)


## Related topics

- [Services C API overview - PFSegments.h](/ja-jp/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerTagsAsync](/ja-jp/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)
- [PFSegmentsServerRemovePlayerTagAsync](/ja-jp/services/playfab/api-references/c/pfsegments/functions/pfsegmentsserverremoveplayertagasync.md)
- [PFSegmentsServerGetPlayerTagsGetResult](/ja-jp/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsgetresult.md)
- [PFSegmentsAddPlayerTagRequest](/ja-jp/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsaddplayertagrequest.md)