nn::cec::CTR::MessageBox::CreateMessageBox Member Function

nn::Result CreateMessageBox(
     const TitleId cecTitleId,
     const u32 privateId,
     const char * hmacKey,
     void * icon,
     size_t iconSize,
     wchar_t * name,
     size_t nameSize,
     size_t inboxSizeMax = CEC_INBOX_SIZE_DEFAULT,
     size_t outboxSizeMax = CEC_OUTBOX_SIZE_DEFAULT,
     size_t inboxMessNumMax = CEC_INBOX_MESSNUM_DEFAULT,
     size_t outboxMessNumMax = CEC_OUTBOX_MESSNUM_DEFAULT,
     size_t messageSizeMax = CEC_MESSSIZEMAX_DEFAULT
);

nn::Result CreateMessageBox(
     const TitleId cecTitleId,
     const u32 privateId,
     const char * hmacKey,
     size_t inboxSizeMax = CEC_INBOX_SIZE_DEFAULT,
     size_t outboxSizeMax = CEC_OUTBOX_SIZE_DEFAULT,
     size_t inboxMessNumMax = CEC_INBOX_MESSNUM_DEFAULT,
     size_t outboxMessNumMax = CEC_OUTBOX_MESSNUM_DEFAULT,
     size_t messageSizeMax = CEC_MESSSIZEMAX_DEFAULT
);

MessageBox objects are created in NAND memory. Only one box may be created for each application. Only 12 boxes may be created in total. Attempting to create a new message box when 12 already exist will not create a new box.

The privateId and hmacKey values are used to restrict access. The privateId value is the key needed to open a message box and is intended to be limited to one system. The hmacKey value is a key common to all instances of an application and is used to prevent data tampering and application spoofing. These keys are stored in the message box. Set shared keys in an appropriate configuration if you need to access the same message box from multiple save-data files or applications.

There are two types of StreetPass icons used on System Settings screens and other screens. There is a box icon and an icon for individual messages. You must specify both. This function sets the box icon.

(In the final version, icons and application names must be set. This format is maintained for compatibility with previous versions.)