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

# XblAchievement

> XblAchievement

# XblAchievement

実績を表します。実績とは、すべてのゲームを通じて一貫してユーザーのゲーム内アクションを誘導し報酬を与えるシステム全体のメカニズムです。

## 構文

```cpp theme={null}
typedef struct XblAchievement {  
    const char* id;  
    const char* serviceConfigurationId;  
    const char* name;  
    XblAchievementTitleAssociation* titleAssociations;  
    size_t titleAssociationsCount;  
    XblAchievementProgressState progressState;  
    XblAchievementProgression progression;  
    XblAchievementMediaAsset* mediaAssets;  
    size_t mediaAssetsCount;  
    const char** platformsAvailableOn;  
    size_t platformsAvailableOnCount;  
    bool isSecret;  
    const char* unlockedDescription;  
    const char* lockedDescription;  
    const char* productId;  
    XblAchievementType type;  
    XblAchievementParticipationType participationType;  
    XblAchievementTimeWindow available;  
    XblAchievementReward* rewards;  
    size_t rewardsCount;  
    uint64_t estimatedUnlockTime;  
    const char* deepLink;  
    bool isRevoked;  
} XblAchievement  
```

### メンバー

*id*\
型: const char\*

UTF-8 エンコードされた実績 ID。uint を表します。

*serviceConfigurationId*\
型: const char\*

実績に関連付けられているサービス構成 ID (SCID)。SCID は大文字と小文字が区別されるので、パートナー センターから直接貼り付けてください。

*name*\
型: const char\*

UTF-8 エンコードされたローカライズ済み実績名。

*titleAssociations*\
型: [XblAchievementTitleAssociation\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementtitleassociation)

実績に関連付けられているゲーム/アプリのタイトル。

*titleAssociationsCount*\
型: size\_t

**titleAssociations** のサイズ。

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

実績獲得に向けたユーザーの進捗状態。

*progression*\
型: [XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression)

要件を含む、実績の進捗詳細情報を格納した progression オブジェクト。

*mediaAssets*\
型: [XblAchievementMediaAsset\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

イメージ ID など、実績に関連付けられているメディア アセット。

*mediaAssetsCount*\
型: size\_t

**mediaAssets** のサイズ。

*platformsAvailableOn*\
型: const char\*\*

実績が使用可能なプラットフォームの UTF-8 エンコードされたコレクション。

*platformsAvailableOnCount*\
型: size\_t

**platformsAvailableOn** のサイズ。

*isSecret*\
型: bool

実績がシークレットかどうか。

*unlockedDescription*\
型: const char\*

UTF-8 エンコードされたアンロック済み実績の説明。

*lockedDescription*\
型: const char\*

UTF-8 エンコードされたロック済み実績の説明。

*productId*\
型: const char\*

実績がリリースされた際の UTF-8 エンコードされた product\_id。これは、アプリケーション、ダウンロード可能コンテンツなどに対応する可能性があるグローバルに一意の識別子です。

*type*\
型: [XblAchievementType](/reference/live/xsapi-c/achievements_c/enums/xblachievementtype)

チャレンジ実績など、実績の種類。

*participationType*\
型: [XblAchievementParticipationType](/reference/live/xsapi-c/achievements_c/enums/xblachievementparticipationtype)

グループまたは個人など、実績の参加種別。

*available*\
型: [XblAchievementTimeWindow](/reference/live/xsapi-c/achievements_c/structs/xblachievementtimewindow)

実績が利用可能な時間帯。チャレンジに適用されます。

*rewards*\
型: [XblAchievementReward\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementreward)

実績がアンロックされたときにプレイヤーが獲得する報酬のコレクション。

*rewardsCount*\
型: size\_t

**rewards** のサイズ。

*estimatedUnlockTime*\
型: uint64\_t

実績を獲得するのに要する推定時間。

*deepLink*\
型: const char\*

実績のための望ましい開始点でタイトルを起動できる、クライアント用の UTF-8 エンコードされたディープ リンク。

*isRevoked*\
型: bool

実績が強制によって取り消されているかどうかを示す値。

## 引数の型

[XblAchievementsResultGetAchievements](/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements)

## 要件

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

## 関連項目

[achievements\_c](/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [XblAchievementsResultGetAchievements](/ja-jp/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)
- [XblAchievementProgression](/ja-jp/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression.md)
- [XblAchievementType](/ja-jp/reference/live/xsapi-c/achievements_c/enums/xblachievementtype.md)
- [XblAchievementReward](/ja-jp/reference/live/xsapi-c/achievements_c/structs/xblachievementreward.md)
- [XblAchievementsManagerResultGetAchievements](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)