include/notification_status.h

   1 /*
   2  *  libnotification
   3  *
   4  * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
   5  *
   6  * Contact: Seungtaek Chung <seungtaek.chung@samsung.com>, Mi-Ju Lee <miju52.lee@samsung.com>, Xi Zhichan <zhichan.xi@samsung.com>
   7  *
   8  * Licensed under the Apache License, Version 2.0 (the "License");
   9  * you may not use this file except in compliance with the License.
  10  * You may obtain a copy of the License at
  11  *
  12  * http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  *
  20  */
  21
  22 #ifndef __NOTIFICATION_STATUS_DEF_H__
  23 #define __NOTIFICATION_STATUS_DEF_H__
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif /* __cplusplus */
  28
  29 /**
  30  * @file notification_status.h
  31  */
  32
  33 /**
  34  * @addtogroup NOTIFICATION_STATUS
  35  * @{
  36  */
  37
  38 /**
  39  * @brief Sends a string (message) to the notification status monitor.
  40  * @since_tizen 2.3
  41  * @privlevel public
  42  * @privilege %http://tizen.org/privilege/notification
  43  * @param[in] message The messages to be posted
  44
  45  * @return  #NOTIFICATION_ERROR_NONE on success,
  46  *          otherwise any other value on failure
  47  * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
  48  * @retval #NOTIFICATION_ERROR_FROM_DBUS Error from DBus
  49  * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
  50  * @see #notification_error_e
  51  */
  52 int notification_status_message_post(const char *message);
  53
  54 /**
  55  * @}
  56  */
  57
  58 #ifdef __cplusplus
  59 }
  60 #endif /* __cplusplus */
  61 #endif /* __NOTIFICATION_STATUS_DEF_H__ */