1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
#pragma once
// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
#ifdef __cplusplus
extern "C" {
#endif
#define LogExitOnFailureSource(d, x, i, f, ...) if (FAILED(x)) { LogErrorId(x, i, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define LogExitOnRootFailureSource(d, x, i, f, ...) if (FAILED(x)) { LogErrorId(x, i, __VA_ARGS__); Dutil_RootFailure(__FILE__, __LINE__, x); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define LogExitOnFailure(x, i, f, ...) LogExitOnFailureSource(DUTIL_SOURCE_DEFAULT, x, i, f, __VA_ARGS__)
#define LogExitOnRootFailure(x, i, f, ...) LogExitOnRootFailureSource(DUTIL_SOURCE_DEFAULT, x, i, f, __VA_ARGS__)
typedef HRESULT (DAPI *PFN_LOGSTRINGWORKRAW)(
__in_z LPCSTR szString,
__in_opt LPVOID pvContext
);
// enums
// structs
// functions
BOOL DAPI IsLogInitialized();
BOOL DAPI IsLogOpen();
void DAPI LogInitialize(
__in HMODULE hModule
);
HRESULT DAPI LogOpen(
__in_z_opt LPCWSTR wzDirectory,
__in_z LPCWSTR wzLog,
__in_z_opt LPCWSTR wzPostfix,
__in_z_opt LPCWSTR wzExt,
__in BOOL fAppend,
__in BOOL fHeader,
__out_z_opt LPWSTR* psczLogPath
);
void DAPI LogDisable();
void DAPI LogRedirect(
__in_opt PFN_LOGSTRINGWORKRAW vpfLogStringWorkRaw,
__in_opt LPVOID pvContext
);
HRESULT DAPI LogRename(
__in_z LPCWSTR wzNewPath
);
void DAPI LogClose(
__in BOOL fFooter
);
void DAPI LogUninitialize(
__in BOOL fFooter
);
BOOL DAPI LogIsOpen();
HRESULT DAPI LogSetSpecialParams(
__in_z_opt LPCWSTR wzSpecialBeginLine,
__in_z_opt LPCWSTR wzSpecialAfterTimeStamp,
__in_z_opt LPCWSTR wzSpecialEndLine
);
REPORT_LEVEL DAPI LogSetLevel(
__in REPORT_LEVEL rl,
__in BOOL fLogChange
);
REPORT_LEVEL DAPI LogGetLevel();
HRESULT DAPI LogGetPath(
__out_ecount_z(cchLogPath) LPWSTR pwzLogPath,
__in DWORD cchLogPath
);
HANDLE DAPI LogGetHandle();
HRESULT DAPIV LogString(
__in REPORT_LEVEL rl,
__in_z __format_string LPCSTR szFormat,
...
);
HRESULT DAPI LogStringArgs(
__in REPORT_LEVEL rl,
__in_z __format_string LPCSTR szFormat,
__in va_list args
);
HRESULT DAPIV LogStringLine(
__in REPORT_LEVEL rl,
__in_z __format_string LPCSTR szFormat,
...
);
HRESULT DAPI LogStringLineArgs(
__in REPORT_LEVEL rl,
__in_z __format_string LPCSTR szFormat,
__in va_list args
);
HRESULT DAPI LogIdModuleArgs(
__in REPORT_LEVEL rl,
__in DWORD dwLogId,
__in_opt HMODULE hModule,
__in va_list args
);
/*
* Wraps LogIdModuleArgs, so inline to save the function call
*/
inline HRESULT LogId(
__in REPORT_LEVEL rl,
__in DWORD dwLogId,
...
)
{
HRESULT hr = S_OK;
va_list args;
va_start(args, dwLogId);
hr = LogIdModuleArgs(rl, dwLogId, NULL, args);
va_end(args);
return hr;
}
/*
* Wraps LogIdModuleArgs, so inline to save the function call
*/
inline HRESULT LogIdArgs(
__in REPORT_LEVEL rl,
__in DWORD dwLogId,
__in va_list args
)
{
return LogIdModuleArgs(rl, dwLogId, NULL, args);
}
HRESULT DAPIV LogErrorString(
__in HRESULT hrError,
__in_z __format_string LPCSTR szFormat,
...
);
HRESULT DAPI LogErrorStringArgs(
__in HRESULT hrError,
__in_z __format_string LPCSTR szFormat,
__in va_list args
);
HRESULT DAPI LogErrorIdModule(
__in HRESULT hrError,
__in DWORD dwLogId,
__in_opt HMODULE hModule,
__in_z_opt LPCWSTR wzString1,
__in_z_opt LPCWSTR wzString2,
__in_z_opt LPCWSTR wzString3
);
inline HRESULT LogErrorId(
__in HRESULT hrError,
__in DWORD dwLogId,
__in_z_opt LPCWSTR wzString1 = NULL,
__in_z_opt LPCWSTR wzString2 = NULL,
__in_z_opt LPCWSTR wzString3 = NULL
)
{
return LogErrorIdModule(hrError, dwLogId, NULL, wzString1, wzString2, wzString3);
}
HRESULT DAPI LogHeader();
HRESULT DAPI LogFooter();
HRESULT LogStringWorkRaw(
__in_z LPCSTR szLogData
);
#ifdef __cplusplus
}
#endif
|
