#include <dwc.h>
BOOL DWC_SetOwnStatusString( const char* statusString );
Sets the status string within the DS's own 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 string. This is configured by the application and managed on the GameSpy server. Refer to the return value column of the DWC_GetFriendStatus function for different types of status flags.
To use this function, you must complete a login using the DWC_LoginAsync function.
This set string can be obtained by other hosts using the DWC_GetFriendStatus* functions.
Do not use / or \\ within the status string, because the library uses them as delimiters. When you want to use these strings, save them as binary data using the DWC_SetOwnStatusData function.
The set string is cleared when the DWC_ShutdownFriendsMatch function is called.
statusString |
String set in the "status" string. Up to 255 characters plus the NULL terminator character. If a string longer than this is specified, it is truncated at the 256th character. |
TRUE |
Set successful. |
FALSE |
Failed to set status for reasons such as not yet logged in. |
DWC_GetFriendStatus
DWC_GetFriendStatusSC
DWC_SetOwnStatusData
DWC_GetOwnStatusString
2005/12/16 Added the description regarding the communication status.
2005/11/07 Initial version.
CONFIDENTIAL