NWC24ReadMsgTextEx

C Specification

#include <revolution/nwc24.h>

NWC24Err NWC24ReadMsgTextEx(
    const NWC24MsgObj* obj,
    char*              buffer,
    u32                bufSize,
    char*              csNameBuf,
    u32                csNameSize
);

Description

Reads the string data that represents body text of the message from message data. The actual message data is opened, and the string is extracted into memory. The name of character code set by the sender (Charset) is also retrieved as a character string at the same time.

The string to be retrieved is terminated with '\0' (NULL character).

Arguments

`obj`	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`.
`csNameBuf`	Pointer to the memory storing the name of the character code that was read.
`csNameSize`	Size of the region specified by `csNameBuf`.

Return Values

NWC24_OK: Normal exit.
NWC24_ERR_LIB_NOT_OPENED: Library is not open.
NWC24_ERR_PROTECTED: Cannot read message object.
NWC24_ERR_NULL: Message data not set.
NWC24_ERR_OVERFLOW: Message body set for message object overflowed buffer.
NWC24_ERR_NOT_SUPPORTED: Unsupported character code or MIME encoding type set for message object.
NWC24_ERR_FILE_*: Internal file operation error.

Revision History

2006/12/05 Initial version.