/src/logging-log4cxx/src/main/include/log4cxx/nt/nteventlogappender.h
Line | Count | Source (jump to first uncovered line) |
1 | | /* |
2 | | * Licensed to the Apache Software Foundation (ASF) under one or more |
3 | | * contributor license agreements. See the NOTICE file distributed with |
4 | | * this work for additional information regarding copyright ownership. |
5 | | * The ASF licenses this file to You under the Apache License, Version 2.0 |
6 | | * (the "License"); you may not use this file except in compliance with |
7 | | * the License. You may obtain a copy of the License at |
8 | | * |
9 | | * http://www.apache.org/licenses/LICENSE-2.0 |
10 | | * |
11 | | * Unless required by applicable law or agreed to in writing, software |
12 | | * distributed under the License is distributed on an "AS IS" BASIS, |
13 | | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
14 | | * See the License for the specific language governing permissions and |
15 | | * limitations under the License. |
16 | | */ |
17 | | |
18 | | #ifndef _LOG4CXX_NT_EVENT_LOG_APPENDER_HEADER_ |
19 | | #define _LOG4CXX_NT_EVENT_LOG_APPENDER_HEADER_ |
20 | | |
21 | | #include <log4cxx/appenderskeleton.h> |
22 | | |
23 | | namespace LOG4CXX_NS |
24 | | { |
25 | | namespace nt |
26 | | { |
27 | | /** |
28 | | * Appends log events to NT EventLog. |
29 | | */ |
30 | | class LOG4CXX_EXPORT NTEventLogAppender : public AppenderSkeleton |
31 | | { |
32 | | public: |
33 | | DECLARE_LOG4CXX_OBJECT(NTEventLogAppender) |
34 | 0 | BEGIN_LOG4CXX_CAST_MAP() |
35 | 0 | LOG4CXX_CAST_ENTRY(NTEventLogAppender) |
36 | 0 | LOG4CXX_CAST_ENTRY_CHAIN(AppenderSkeleton) |
37 | 0 | END_LOG4CXX_CAST_MAP() |
38 | | |
39 | | NTEventLogAppender(); |
40 | | NTEventLogAppender(const LogString& server, const LogString& log, |
41 | | const LogString& source, const LayoutPtr& layout); |
42 | | |
43 | | virtual ~NTEventLogAppender(); |
44 | | |
45 | | /** |
46 | | \copybrief AppenderSkeleton::activateOptions() |
47 | | |
48 | | Calls <a href="https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-registereventsourcew">RegisterEventSource</a>. |
49 | | */ |
50 | | void activateOptions(helpers::Pool& p) override; |
51 | | void close() override; |
52 | | |
53 | | /** |
54 | | \copybrief AppenderSkeleton::setOption() |
55 | | |
56 | | Supported options | Supported values | Default value | |
57 | | -------------- | ---------------- | --------------- | |
58 | | Server | (\ref winapi "1") | NULL | |
59 | | Source | (\ref winapi "1") | - | |
60 | | Log | (\ref eventLog "2") | Application | |
61 | | |
62 | | \anchor winapi (1) Passed to the Win32 API method <a href="https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-registereventsourcew">RegisterEventSource</a>. |
63 | | |
64 | | \anchor eventLog (2) An event log name. |
65 | | |
66 | | \sa AppenderSkeleton::setOption() |
67 | | */ |
68 | | void setOption(const LogString& option, const LogString& value) override; |
69 | | |
70 | | /** |
71 | | * The SocketAppender does not use a layout. Hence, this method |
72 | | * returns <code>false</code>. |
73 | | * |
74 | | */ |
75 | | bool requiresLayout() const override |
76 | 0 | { |
77 | 0 | return true; |
78 | 0 | } |
79 | | |
80 | | void setSource(const LogString& source); |
81 | | |
82 | | const LogString& getSource() const; |
83 | | |
84 | | void setLog(const LogString& log); |
85 | | |
86 | | const LogString& getLog() const; |
87 | | |
88 | | void setServer(const LogString& server); |
89 | | |
90 | | const LogString& getServer() const; |
91 | | |
92 | | |
93 | | protected: |
94 | | // |
95 | | // these typedef are proxies for the real Win32 definitions |
96 | | // and need to be cast to the global definitions before |
97 | | // use with a Win32 API call |
98 | | typedef void SID; |
99 | | typedef void* HANDLE; |
100 | | |
101 | | void append(const spi::LoggingEventPtr& event, helpers::Pool& p) override; |
102 | | static unsigned short getEventType(const spi::LoggingEventPtr& event); |
103 | | static unsigned short getEventCategory(const spi::LoggingEventPtr& event); |
104 | | /* |
105 | | * Add this source with appropriate configuration keys to the registry. |
106 | | */ |
107 | | void addRegistryInfo(); |
108 | | |
109 | | struct NTEventLogAppenderPrivate; |
110 | | static LogString getErrorString(const LogString& function); |
111 | | |
112 | | private: |
113 | | NTEventLogAppender(const NTEventLogAppender&); |
114 | | NTEventLogAppender& operator=(const NTEventLogAppender&); |
115 | | }; // class NTEventLogAppender |
116 | | |
117 | | LOG4CXX_PTR_DEF(NTEventLogAppender); |
118 | | |
119 | | } // namespace nt |
120 | | } // namespace log4cxx |
121 | | |
122 | | #endif //_LOG4CXX_NT_EVENT_LOG_APPENDER_HEADER_ |