nn::cec::CTR::Message::NewMessage Member Function

Syntax

nn::Result NewMessage(
     TitleId cecTitleId,
     u32 groupId,
     MessageTypeFlag messageTypeFlag,
     SendMode sendMode,
     u8 sendCount,
     u8 propagationCount,
     void * icon,
     size_t iconSize,
     wchar_t * infoTextData,
     size_t infoTextSize
);

Arguments

Name Description
in cecTitleId Unique title ID.
in groupId The message group ID is the value set by the SetGroupID function.
in messageTypeFlag Specifies whether the recipient is a friend or a non-friend using the MessageTypeFlag enumerated type.
in sendMode Specifies the send mode (receive only, send only, send and receive, or exchange) using the SendMode enumerated type. Use the value set by the SetSendMode function.
in sendCount The sendCount and propagationCount values cannot both be set to greater than 1 at the same time.
in propagationCount The sendCount and propagationCount values cannot both be set to greater than 1 at the same time.
in icon Specifies an icon.
Format: RGB565 (little-endian)
Size: 40 x 40 (3200 B)
in iconSize Specifies the size of the icon data.
in infoTextData Sets the information text of a Message. Encoding UTF16-LE
Display size: The number of characters displayable as two lines of 16 double-byte characters
Maximum buffer size: 128 x 2 B (including line breaks and the NULL terminator)
in infoTextSize Specifies the data size for the information text of a Message.

Return Values

nn::Result

Description

Creates a new message.

This function sets the basic parameters. A message is sent during StreetPass communication after the message body is set by the SetMessageBody function and the message is written to the outbox by the MessageBox::WriteMessage function.

Revision History

2010/08/16
Initial version.

CONFIDENTIAL