nn::news::CTR::user::PostNewsUrl Function

Syntax

Result PostNewsUrl(
     const wchar_t * subject,
     const wchar_t * message,
     const u8 * url,
     u8 * workBuf,
     const u8 * picture = NULL,
     size_t pictureSize = 0,
     u32 serialId = 0,
     u32 dataVersion = 0,
     u64 jumpParam = 0
);

Parameters

Name Description
in subject Specifies the subject. Use a UTF16-LE string of up to SUBJECT_LEN characters (including the null-terminator). Data is copied within the function.
in message Specifies the message body. Use UTF-16LE and keep the string length within MESSAGE_LEN (including the null terminator). The buffer size of this and url combined must be 6,000 bytes or smaller. Data are copied internally by function.
in url Specifies the URL. Use UTF-8 and keep the string length within MESSAGE_URL_URL_SIZE (including the null terminator). The buffer size of this and message combined must be 6,000 bytes or smaller. Data are copied internally by function.
in workBuf Specifies the work buffer for posting a notification that has an embedded URL. Calculate the size using GetWorkBufferSizeForNewUrl.
in picture Specifies an image. Use a format of JPEG or MPO (two JPEG images) and a size of 400 x 240 pixels. Data is copied within the function.
in pictureSize Specifies a size for the image, using a value equal to or less than PICTURE_SIZE.
in serialId Specifies the Notification serial ID. For now, always specify 0.
in dataVersion Specifies the Notification data version. For now, always specify 0.
in jumpParam Specifies the jump parameter. You can get this value when the application was started from the Notifications applet.

Return Values

Returns the result of the operation.

Description

Posts a notification with an embedded URL.

Revision History

2011/09/29
Changed the function arguments.
2011/09/16
Initial version.

CONFIDENTIAL