#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 |
Message object from which settings are to be extracted. |
buffer |
Pointer to the region where the read string is stored. |
bufSize |
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: The sender address set for the message object overflowed the buffer.
NWC24_ERR_FILE_*: Internal file operation error.
NWC24_ERR_NAND_CORRUPT: Fatal corruption in Wii console NAND memory.
NWC24_ERR_INTERNAL_VF: VF error caused by an internal function call.
2008/01/17 Added return values that had been omitted.
2006/10/06 Updated the list of return values.
2006/08/01 Initial version.
CONFIDENTIAL