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. This key is stored in the message box. Set a shared key of the appropriate range if you need to access the same message box from multiple save data files or applications.

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