Class template basic_simple_event_log_backend . Boost , Chapter 1. Boost.Log v2 , Sinks

Class template basic_simple_event_log_backend

boost::log::sinks::basic_simple_event_log_backend — An implementation of a simple logging sink backend that emits events into Windows NT event log.

Synopsis

// In header: <boost/log/sinks/event_log_backend.hpp>
template<typename CharT> 
class basic_simple_event_log_backend :
  public basic_formatted_sink_backend< CharT, concurrent_feeding >
{
public:
  // types
  typedef base_type::char_type   char_type;               // Character type. 
  typedef base_type::string_type string_type;             // String type to be used as a message text holder. 
  typedef unspecified            event_type_mapper_type;  // Mapper type for the event type. 
  // construct/copy/destruct
  basic_simple_event_log_backend();
  template<typename... ArgsT> 
    explicit basic_simple_event_log_backend(ArgsT...const &);
  ~basic_simple_event_log_backend();
  // public member functions
  void set_event_type_mapper(event_type_mapper_type const &);
  void consume(record_view const &, string_type const &);
  // public static functions
  static string_type get_default_log_name();
  static string_type get_default_source_name();
};

Description

Ячейка использует Windows NT 5 (Windows 2000) и более поздний API журнала событий для передачи событий в журнал событий. Поглотитель выступает в качестве источника событий с точки зрения API, он реализует все необходимые ресурсы и регистрацию источников в реестре Windows, которые необходимы для доставки событий.

Backend выполняет форматирование текста сообщения. Сочиненный текст затем передается в качестве первого и единственного струнного параметра события. Ресурс, встроенный в бэкэнд, описывает событие так, что параметр вставляется в текст описания события, тем самым делая его видимым в журнале событий.

Бэкэнд позволяет настраивать отображение уровней серьезности приложений на родные типы событий Windows. Это позволяет писать портативный код, даже если используются специальные раковины ОС, такие как эта.

Note

Поскольку бэкэнд регистрируется в реестре Windows как файл ресурса, содержащий описание событий, важно сохранить бинарную библиотеку в стабильном месте файловой системы. В противном случае Windows не сможет правильно загружать ресурсы событий из библиотеки и отображать события.

Известно, что Windows не может найти ресурсы событий в исполняемом приложении, который связан со статической сборкой библиотеки. Пользователям рекомендуется использовать динамические сборки библиотеки для решения этой задачи.

`basic_simple_event_log_backend` public construct/copy/destruct

```
basic_simple_event_log_backend();
```
Конструктор по умолчанию. Регистрирует источник событий с именем на основе исполняемого файла приложения в журнале приложений. Если такая регистрация уже присутствует, она не переопределяется.
<
```
template<typename...ArgsT>
 explicitbasic_simple_event_log_backend(ArgsT...const&args);
```
>
Конструктор. Регистрирует источник журнала событий с заданными параметрами. Поддерживаются следующие названные параметры:
- <target>— указывает путь UNC к удаленному серверу, на который должны быть отправлены записи журнала. Местная машина будет использоваться для обработки записей журнала, если не указано.
- <log_name>— указывает журнал, в котором должен быть зарегистрирован источник. Результат<get_default_log_name>используется, если параметр не указан.
- <log_source>— указывает имя источника. Результат<get_default_source_name>используется, если параметр не указан.
- <registration>- Указывает режим регистрации источника событий в реестре Windows. Может иметь значения<registration_mode>. Значение по умолчанию:<on_demand>
Параметры:
args
Набор названных параметров.
<
```
~basic_simple_event_log_backend();
```
>
Разрушитель. Незарегистрированный источник событий. Описание источника журнала не удаляется из реестра Windows.

`basic_simple_event_log_backend` public member functions

```
voidset_event_type_mapper(event_type_mapper_typeconst&mapper);
```
Метод устанавливает объект функции, который отображает уровни тяжести приложения для типов событий WinAPI.
```
voidconsume(record_viewconst&rec,string_typeconst&formatted_message);
```
Метод помещает отформатированное сообщение в журнал событий

`basic_simple_event_log_backend` public static functions

```
staticstring_typeget_default_log_name();
```
Возврат:
Имя журнала по умолчанию: Приложение

staticstring_typeget_default_source_name();

Возврат:

Имя источника журнала по умолчанию, основанное на имени исполняемого файла приложения и имени раковины

Статья Class template basic_simple_event_log_backend раздела Chapter 1. Boost.Log v2 Sinks может быть полезна для разработчиков на c++ и boost.

Class template basic_simple_event_log_backend

Boost , Chapter 1. Boost.Log v2 , Sinks

Boost C++ Libraries

Class template basic_simple_event_log_backend

Synopsis

Description

basic_simple_event_log_backend public construct/copy/destruct

basic_simple_event_log_backend public member functions

basic_simple_event_log_backend public static functions

`basic_simple_event_log_backend` public construct/copy/destruct

`basic_simple_event_log_backend` public member functions

`basic_simple_event_log_backend` public static functions