1 /*---------------------------------------------------------------------------*
2   Project:  news
3   File:     news_UserApi.h
4 
5   Copyright (C)2010 Nintendo Co., Ltd.  All rights reserved.
6 
7   These coded instructions, statements, and computer programs contain
8   proprietary information of Nintendo of America Inc. and/or Nintendo
9   Company Ltd., and are protected by Federal copyright law.  They may
10   not be disclosed to third parties or copied or duplicated in any form,
11   in whole or in part, without the prior written consent of Nintendo.
12 
13   $Rev$
14  *---------------------------------------------------------------------------*/
15 
16 #ifndef NN_NEWS_CTR_NEWS_USER_USERAPI_H_
17 #define NN_NEWS_CTR_NEWS_USER_USERAPI_H_
18 
19 #include <nn/fnd.h>
20 #include <nn/Result.h>
21 #include <nn/types.h>
22 
23 namespace nn {
24 namespace news {
25 namespace CTR {
26 namespace user {
27 
28 /*!
29   @brief        おしらせライブラリの初期化をします. おしらせライブラリ使用前に一度呼び出してください.
30   @return       処理の結果が返ります.
31 */
32 Result
33 Initialize();
34 
35 /*!
36   @brief        おしらせライブラリの後始末をします. おしらせライブラリ使用後に一度呼び出してください.
37   @return       処理の結果が返ります.
38 */
39 Result
40 Finalize();
41 
42 /*!
43   @brief        おしらせを投稿します.
44   @param[in]    subject         表題を指定します. UTF16-LEで @ref SUBJECT_LEN 以下(NULL終端込み)の文字長にしてください. データは関数内でコピーされます.
45   @param[in]    message         本文を指定します. UTF16-LEで @ref MESSAGE_LEN 以下(NULL終端込み)の文字長にしてください. データは関数内でコピーされます.
46   @param[in]    picture         画像を指定します. jpegまたはmpo(jpeg2枚)の形式で400×240の大きさにしてください. データは関数内でコピーされます.
47   @param[in]    pictureSize     画像のサイズを指定します. @ref PICTURE_SIZE 以下のサイズにしてください.
48   @return       処理の結果が返ります.
49 */
50 Result
51 PostNews(
52     const wchar_t* subject,
53     const wchar_t* message,
54     const u8* picture = NULL,
55     size_t pictureSize = 0
56     );
57 
58 }
59 }
60 }
61 }
62 
63 #endif /* NN_NEWS_CTR_NEWS_USER_USERAPI_H_ */
64