#include <dwc.h>
BOOL DWC_GetOwnStatusString( char* statusString );
Gets the status string from within the system's own current communication status.
The player's communication status is a product of the status flag, which indicates whether the player is online or offline, and the status character string displayed by the argument statusString. It is managed on the GameSpy server. The status flag is automatically set by the DWC library, but the status character string can be configured by the application using the DWC_SetOwnStatusString function. Refer to the return value section of the DWC_GetFriendStatus function for different types of status flags.
Because this function gets the caller's own status string stored within the DWC library, no communications are performed.
To use DWC_GetOwnStatusString, you must complete a login using the DWC_LoginAsync function.
Use the DWC_SetOwnStatusData and DWC_GetOwnStatusData functions when you want to specify or get binary data instead of a string.
statusString |
Pointer to a 256-character buffer to receive the status string. Up to 255 characters plus NULL terminator. |
TRUE |
Acquisition successful. |
FALSE |
Failed to get data because not logged in yet or for other reasons. |
DWC_SetOwnStatusString
DWC_SetOwnStatusData
DWC_GetOwnStatusData
DWC_GetFriendStatus
DWC_GetFriendStatusSC
DWC_LoginAsync
2005/12/16 Added a description about communication status and an introduction to other similar functions.
2005/11/07 Initial version.
CONFIDENTIAL