#include <dwc.h>int DWC_GetOwnStatusData(char *statusData);| statusData | Pointer to where the status data is stored. |
| 0 or higher | Size of binary data retrieved. |
| Negative value | Failed to get data because not logged in yet or for some other reason. |
Gets status data (binary data) from the system's own current communication status.
The player's communication status is a product of the status flag, which displays whether the player is online or offline, and the status character string. It is managed on the GameSpy server. This function presumes that the status string is a character string encoded in Base64. The function obtains the status data (the statusData argument) by decoding the status string. The status flag is automatically set by the DWC library. However, the application can set the status data by using the DWC_SetOwnStatusData function. Refer to the Return Values section of the DWC_GetFriendStatus function for information about the status flag type.
If you set the argument statusData to NULL, you can get just the binary data size without decoding the status data.
This function does not perform any communication to obtain the system's status data stored in the DWC library.
In order to use this function, you must have completed a login using the DWC_LoginAsync function.
Use the DWC_SetOwnStatusString or DWC_GetOwnStatusString function to set or get a character string instead of binary data.
CONFIDENTIAL