rc_api_init_submit_lboard_entry_request

Constructs an rc_api_request_t for submitting a leaderboard entry for a user.

Syntax

int rc_api_init_submit_lboard_entry_request(
    rc_api_request_t* request,
    const rc_api_submit_lboard_entry_request_t* api_params
);

Parameters

request

The rc_api_request_t to construct.

api_params

Pointer to a rc_api_submit_lboard_entry_request_t object containing the parameters for the new leaderboard entry.

---

struct rc_api_submit_lboard_entry_request_t
{
  const char* username;
  const char* api_token;
  unsigned leaderboard_id;
  int score;
  const char* game_hash;
};

username

The name of the user making the request.

api_token

The API token generated by the login request for the user.

leaderboard_id

The unique identifier of the leaderboard for the entry to be associated to.

score

The value to submit for the leaderboard entry.

game_hash

The unique hash for the version of the game being played by the user.

Return value

If the function succeeds, the return value is RC_OK. Otherwise, the error code can be converted to a string using rc_error_str.

• RC_INVALID_STATE - one or more required parameters was not provided.
• RC_OUT_OF_MEMORY - enough memory could not be allocated to complete the operation.

Remarks

The rc_api_request_t must be destroyed by rc_api_destroy_request after the HTTP request has been made.

Minimum version: 10.0.0

See also

rc_api_destroy_request

rc_api_process_submit_lboard_entry_response

rc_api_destroy_submit_lboard_entry_response