#include <dwc.h>DWCRnkError DWC_RnkPutScoreAsync(u32 category,
DWCRnkRegion region,
s32 score,
void *data,
u32 size);| category | Category ID for identifying rankings (category ID is a numeric value ranging from zero to DWC_RNK_CATEGORY_MAX). |
| region | The region code. Specify a single option from those in DWCRnkRegion. |
| score | The score. Specifies an arbitrary numerical value. |
| data | Pointer to the buffer for the user defined data. |
| size | Size of data (equal to or less than DWC_RNK_DATA_MAX). |
| DWC_RNK_SUCCESS | Succeeded. |
| DWC_RNK_IN_ERROR | An error is occurring. |
| DWC_RNK_ERROR_PUT_NOTREADY | Communications could not be prepared. |
| DWC_RNK_ERROR_INVALID_PARAMETER | Invalid parameter. |
| DWC_RNK_ERROR_PUT_INVALID_KEY | Invalid encryption key. |
| DWC_RNK_ERROR_PUT_NOMEMORY | Insufficient memory. |
Starts the asynchronous process for recording the score. Only one asynchronous process can be run at a time. DWC_RNK_ERROR_PUT_NOTREADY is returned if an attempt is made to execute more than one asynchronous process.
Make periodic calls to the DWC_RnkProcess function during the asynchronous process. During the process, DWC_RnkProcess returns DWC_RNK_SUCCESS.
Call the DWC_RnkGetState function to get the state of progress of the asynchronous process.
Be sure to make backups as necessary when executing asynchronous processes in succession because some members inside the DWCRnkDatastructure obtained using the DWC_RnkResGetRow function directly access the receive buffer.
When user-defined data is not used, specify NULL for data and 0 for size.
The size of the user-defined data designated in data is corrected to a size that is an integer multiple of 4 on the server. For example, if the size is specified as 3 bytes, then 1 byte of dummy data will be added and 4 bytes will be registered. The data size that the DWC_RnkResGetRow function gets is this corrected data size.
CONFIDENTIAL