/*---------------------------------------------------------------------------*
  Project:  news
  File:     news_UserApi.h

  Copyright (C)2010 Nintendo Co., Ltd.  All rights reserved.

  These coded instructions, statements, and computer programs contain
  proprietary information of Nintendo of America Inc. and/or Nintendo
  Company Ltd., and are protected by Federal copyright law.  They may
  not be disclosed to third parties or copied or duplicated in any form,
  in whole or in part, without the prior written consent of Nintendo.

  $Rev$
 *---------------------------------------------------------------------------*/

#ifndef NN_NEWS_CTR_NEWS_USER_USERAPI_H_
#define NN_NEWS_CTR_NEWS_USER_USERAPI_H_

#include <nn/fnd.h>
#include <nn/Result.h>
#include <nn/types.h>

namespace nn {
namespace news {
namespace CTR {
namespace user {

/*!
  @brief        おしらせライブラリの初期化をします. おしらせライブラリ使用前に一度呼び出してください.
  @return       処理の結果が返ります.
*/
Result
Initialize();

/*!
  @brief        おしらせライブラリの後始末をします. おしらせライブラリ使用後に一度呼び出してください.
  @return       処理の結果が返ります.
*/
Result
Finalize();

/*!
  @brief        おしらせを投稿します.
  @param[in]    subject         表題を指定します. UTF16-LEで @ref SUBJECT_LEN 以下(NULL終端込み)の文字長にしてください. データは関数内でコピーされます.
  @param[in]    message         本文を指定します. UTF16-LEで @ref MESSAGE_LEN 以下(NULL終端込み)の文字長にしてください. データは関数内でコピーされます.
  @param[in]    picture         画像を指定します. jpegまたはmpo(jpeg2枚)の形式で400×240の大きさにしてください. データは関数内でコピーされます.
  @param[in]    pictureSize     画像のサイズを指定します. @ref PICTURE_SIZE 以下のサイズにしてください.
  @return       処理の結果が返ります.
*/
Result
PostNews(
    const wchar_t* subject,
    const wchar_t* message,
    const u8* picture = NULL,
    size_t pictureSize = 0
    );

}
}
}
}

#endif /* NN_NEWS_CTR_NEWS_USER_USERAPI_H_ */