#include <revolution/nwc24.h>NWC24Err NWC24ReadMsgFromAddr( const NWC24MsgObj* obj, char* buffer, u32 bufSize );
Reads the character string representing the address of the sender of the message from message data. Messages that are handled as standard e-mail differ from those handled among Wii Consoles in that the sender's information cannot be retrieved as an ID when the message object is read. Therefore, this function needs to be called to open the actual message data and extract the string.
This function is valid only for messages exchanged with standard e-mail addresses.
The returned string will be null (\0) terminated.
obj |
The message object from which settings are to be extracted. |
buffer |
Pointer to the region where the read string is stored. |
bufSize |
The size of the region specified by buffer. |
NWC24_OK: Normal exit.
NWC24_ERR_LIB_NOT_OPENED: Library not open.
NWC24_ERR_PROTECTED: Message object cannot be read.
NWC24_ERR_NOT_SUPPORTED: Unsupported message object specified for obj.
NWC24_ERR_INVALID_VALUE: Invalid value set for message object setting.
NWC24_ERR_NULL: Message data not set.
NWC24_ERR_OVERFLOW: Sender address set for the message object overflowed the buffer.
NWC24_ERR_FILE_*: Internal file operation error.
2006/10/06 Updated return value list.
2006/08/01 Initial version.
CONFIDENTIAL