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

# XblAchievementsManagerGetAchievementsByState

> XblAchievementsManagerGetAchievementsByState

# XblAchievementsManagerGetAchievementsByState

プレイヤーの特定の進捗状態にある実績のリストを取得します。

## 構文

```cpp theme={null}
HRESULT XblAchievementsManagerGetAchievementsByState(  
         uint64_t xboxUserId,  
         XblAchievementOrderBy sortField,  
         XblAchievementsManagerSortOrder sortOrder,  
         XblAchievementProgressState achievementState,  
         XblAchievementsManagerResultHandle* achievementsResult  
)  
```

### パラメーター

*xboxUserId*   \_In\_\
型: uint64\_t

プレイヤーの XBOX ユーザー ID。

*sortField*   \_In\_\
型: [XblAchievementOrderBy](/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby)

実績リストのソート対象フィールド。AchievementsManager は一度に 1 つのタイトルしか処理しないため、TitleId は DefaultOrder と同じ動作になります。

*sortOrder*   \_In\_\
型: [XblAchievementsManagerSortOrder](/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder)

実績リストをソートする方向。

*achievementState*   \_In\_\
型: [XblAchievementProgressState](/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

結果に含める実績の状態。

*achievementsResult*   \_Outptr\_result\_maybenull\_\
型: [XblAchievementsManagerResultHandle\*](/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle)

AchievementsManager API 呼び出しの結果へのハンドル。このハンドルは、呼び出された API に一致する実績オブジェクトを取得するために、他の API によって使用されます。結果が不要になったら、[XblAchievementsManagerResultCloseHandle](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle) を使用してハンドルを閉じる必要があります。

### 戻り値

型: HRESULT

この API 操作の HRESULT 戻り値コード。

## 要件

**ヘッダー:** achievements\_manager\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

[achievements\_manager\_c](/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XBOX Achievements Manager API の概要](/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievement](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerResultGetAchievements](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)
- [XblAchievementsManagerUpdateAchievement](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)