Coverage Report

Created: 2025-08-24 06:21

/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_