プレイヤーの特定の進行状況での実績のリストを取得します。
構文
HRESULT XblAchievementsManagerGetAchievementsByState(
uint64_t xboxUserId,
XblAchievementOrderBy sortField,
XblAchievementsManagerSortOrder sortOrder,
XblAchievementProgressState achievementState,
XblAchievementsManagerResultHandle* achievementsResult
)
パラメーター
xboxUserId _In_
型: uint64_t
プレイヤーの Xbox ユーザー ID。
sortField _In_
型: XblAchievementOrderBy
実績のリストを並べ替えるフィールド。 AchievementsManager は一度に 1 つのタイトルしか処理しないため、TitleId は DefaultOrder と同じように動作します。
sortOrder _In_
型: XblAchievementsManagerSortOrder
実績のリストを並べ替える方向。
achievementState _In_
型: XblAchievementProgressState
結果に含める実績の状態。
achievementsResult _Outptr_result_maybenull_
型: XblAchievementsManagerResultHandle*
AchievementsManager API 呼び出しの結果へのハンドル。 このハンドルは、呼び出された API に一致する実績オブジェクトを取得するために他の API によって使用されます。 結果が不要になった場合は、XblAchievementsManagerResultCloseHandle を使用してハンドルを閉じる必要があります。
戻り値
型: HRESULT
この API 操作の HRESULT 結果コード。
要件
ヘッダー: achievements_manager_c.h
ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib