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>, Youngsub Ko <ys4610.ko@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 * @brief Called when new message is posted
  31 * @param[in] message The message posted
  32 * @param[in] data user data
  33 * @pre notification_status_monitor_message_cb_set() used to register this callback
  34 * @see notification_status_monitor_message_cb_set()
  35 */
  36 typedef void (*notification_status_message_cb)(const char *message, void *data);
  37
  38 /**
  39 * @brief register callback for receiving message
  40 * @param[in] callback The callback function
  41 * @param[in] data user_data
  42 */
  43 int notification_status_monitor_message_cb_set(notification_status_message_cb callback, void *user_data);
  44
  45 /**
  46 * @brief unregister callback for receiving message
  47 * @param[in] callback The callback function
  48 * @param[in] data user_data
  49 */
  50 int notification_status_monitor_message_cb_unset(void);
  51
  52 /**
  53  * @addtogroup NOTIFICATION_STATUS
  54  * @{
  55  */
  56
  57 /**
  58  * @brief This function send string(message) to notification status monitor
  59  * @details Send the message to notification status monitor.
  60  * @param[in] message messages you want to post
  61  * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
  62  * @see #notification_error_e
  63  */
  64 int notification_status_message_post(const char *message);
  65
  66 /**
  67  * @}
  68  */
  69
  70 #ifdef __cplusplus
  71 }
  72 #endif /* __cplusplus */
  73 #endif /* __NOTIFICATION_STATUS_DEF_H__ */