rc_client_begin_fetch_game_titles

Fetches a list of titles and badges for a set of game identifiers.

Syntax

rc_client_async_handle_t* rc_client_begin_fetch_game_titles(
    rc_client_t* client,
    const uint32_t* game_ids,
    uint32_t num_game_ids,
    rc_client_fetch_game_titles_callback_t callback,
    void* callback_userdata
);

Parameters

client

The rc_client_t to use to fetch the leaderboard entries.

game_ids

An array of game ids to query.

num_game_ids

The number of elements in the game_ids array.

callback

Function to call when the list is available.

callback_userdata

Additional information to pass to the callback function.

Returns

Pointer to an rc_client_async_handle_t that can be passed to rc_client_abort_async to cancel the user progress query request. The rc_client_async_handle_t is invalid after callback has been called.

---

rc_client_fetch_all_user_progress_callback_t

void (*rc_client_fetch_game_titles_callback_t)(
    int result,
    const char* error_message,
    rc_client_game_title_list_t* list,
    rc_client_t* client,
    void* userdata
);

result

RC_OK on success, or an error code indicating the failure.

result	problem
RC_OK	User progress entries were successfully retrieved.
RC_INVALID_STATE	Generic failure. See error_message for details.
RC_INVALID_JSON	Server response could not be processed.
RC_MISSING_VALUE	Server response was not complete.
RC_API_FAILURE	Error occurred on the server. See error_message for details.
RC_OUT_OF_MEMORY	Memory could not be allocated to hold the response.

error_message

NULL on success, or a message related to a non-successful result.

list

Pointer to a rc_client_game_title_list_t object containing the requested game information.

It must be released by calling rc_client_destroy_game_title_list.

Will be NULL if an error occurred.

client

The rc_client_t that was handling the load game attempt.

userdata

A client provided pointer passed to the begin function as callback_userdata.

---

rc_client_game_title_list_t

typedef struct rc_client_game_title_list_t{
  rc_client_game_title_entry_t* entries;
  uint32_t num_entries;
} rc_client_game_title_list_t;

entries

An array of game title entries.

num_entries

The number of entries in the entries array.

---

rc_client_game_title_entry_t

typedef struct rc_client_game_title_entry_t{
  uint32_t game_id;
  const char* title;
  char badge_name[16];
  const char* badge_url;
} rc_client_game_title_entry_t;

game_id

The unique identifier of the game.

title

The title of the game.

badge_name

The unique identifier of the image that should be shown when loading or completing the game. See also rc_client_game_get_image_url.

badge_url

A URL to the game's badge image.

Remarks

The rc_client_game_title_list_t instance created by this function must be released by calling rc_client_destroy_game_title_list.

Minimum version: 12.2.0

See also

rc_client_destroy_game_title_list