PFSegmentsServerAddPlayerTagAsync

將指定的標籤新增至玩家設定檔。標籤的命名空間會根據標籤的來源自動產生。

語法

HRESULT PFSegmentsServerAddPlayerTagAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsAddPlayerTagRequest* request,  
    XAsyncBlock* async  
)  

參數

titleEntityHandle PFEntityHandle 使用 PFAuthenticationGetEntityWithSecretKeyAsync 取得之 Title 實體的 PFEntityHandle。 request PFSegmentsAddPlayerTagRequest* 已填入的要求物件。 async XAsyncBlock*
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 成員

PlayFab API

PlayFab REST API References

語法

參數

傳回值

備註

需求

另請參閱

​語法

​參數

​傳回值

​備註

​需求

​另請參閱

語法

參數

傳回值

備註

需求

另請參閱