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
193
194
195
196
197
198
199
|
#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.
#include "dutil.h"
#ifdef __cplusplus
extern "C" {
#endif
#define BalExitOnFailureSource(d, x, f, ...) if (FAILED(x)) { BalLogError(x, f, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define BalExitOnRootFailureSource(d, x, f, ...) if (FAILED(x)) { BalLogError(x, f, __VA_ARGS__); Dutil_RootFailure(__FILE__, __LINE__, x); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define BalExitOnLastErrorSource(d, x, f, ...) { x = ::GetLastError(); x = HRESULT_FROM_WIN32(x); if (FAILED(x)) { BalLogError(x, f, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; } }
#define BalExitOnNullSource(d, p, x, e, f, ...) if (NULL == p) { x = e; BalLogError(x, f, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define BalExitOnNullWithLastErrorSource(d, p, x, f, ...) if (NULL == p) { DWORD Dutil_er = ::GetLastError(); x = HRESULT_FROM_WIN32(Dutil_er); if (!FAILED(x)) { x = E_FAIL; } BalLogError(x, f, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define BalExitWithLastErrorSource(d, x, f, ...) { DWORD Dutil_er = ::GetLastError(); x = HRESULT_FROM_WIN32(Dutil_er); if (!FAILED(x)) { x = E_FAIL; } BalLogError(x, f, __VA_ARGS__); ExitTraceSource(d, x, f, __VA_ARGS__); goto LExit; }
#define BalExitOnFailure(x, f, ...) BalExitOnFailureSource(DUTIL_SOURCE_DEFAULT, x, f, __VA_ARGS__)
#define BalExitOnRootFailure(x, f, ...) BalExitOnRootFailureSource(DUTIL_SOURCE_DEFAULT, x, f, __VA_ARGS__)
#define BalExitOnLastError(x, f, ...) BalExitOnLastErrorSource(DUTIL_SOURCE_DEFAULT, x, f, __VA_ARGS__)
#define BalExitOnNull(p, x, e, f, ...) BalExitOnNullSource(DUTIL_SOURCE_DEFAULT, p, x, e, f, __VA_ARGS__)
#define BalExitOnNullWithLastError(p, x, f, ...) BalExitOnNullWithLastErrorSource(DUTIL_SOURCE_DEFAULT, p, x, f, __VA_ARGS__)
#define BalExitWithLastError(x, f, ...) BalExitWithLastErrorSource(DUTIL_SOURCE_DEFAULT, x, f, __VA_ARGS__)
#ifndef FACILITY_WIX
#define FACILITY_WIX 500
#endif
const LPCWSTR BAL_MANIFEST_FILENAME = L"BootstrapperApplicationData.xml";
static const HRESULT E_WIXSTDBA_CONDITION_FAILED = MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIX, 1);
static const HRESULT E_MBAHOST_NET452_ON_WIN7RTM = MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIX, 1000);
static const HRESULT E_DNCHOST_SCD_RUNTIME_FAILURE = MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIX, 1001);
/*******************************************************************
BalInitialize - remembers the engine interface to enable logging and
other functions.
********************************************************************/
DAPI_(void) BalInitialize(
__in IBootstrapperEngine* pEngine
);
/*******************************************************************
BalInitializeFromCreateArgs - convenience function to call BalBootstrapperEngineCreate
then pass it along to BalInitialize.
********************************************************************/
DAPI_(HRESULT) BalInitializeFromCreateArgs(
__in const BOOTSTRAPPER_CREATE_ARGS* pArgs,
__out_opt IBootstrapperEngine** ppEngine
);
/*******************************************************************
BalUninitialize - cleans up utility layer internals.
********************************************************************/
DAPI_(void) BalUninitialize();
/*******************************************************************
BalManifestLoad - loads the Application manifest into an XML document.
********************************************************************/
DAPI_(HRESULT) BalManifestLoad(
__in HMODULE hUXModule,
__out IXMLDOMDocument** ppixdManifest
);
/*******************************************************************
BalEvaluateCondition - evaluates a condition using variables in the engine.
********************************************************************/
DAPI_(HRESULT) BalEvaluateCondition(
__in_z LPCWSTR wzCondition,
__out BOOL* pf
);
/*******************************************************************
BalFormatString - formats a string using variables in the engine.
Note: Use StrFree() to release psczOut.
********************************************************************/
DAPI_(HRESULT) BalFormatString(
__in_z LPCWSTR wzFormat,
__inout LPWSTR* psczOut
);
/*******************************************************************
BalGetNumericVariable - gets a number from a variable in the engine.
Note: Returns E_NOTFOUND if variable does not exist.
********************************************************************/
DAPI_(HRESULT) BalGetNumericVariable(
__in_z LPCWSTR wzVariable,
__out LONGLONG* pllValue
);
/*******************************************************************
BalSetNumericVariable - sets a numeric variable in the engine.
********************************************************************/
DAPI_(HRESULT) BalSetNumericVariable(
__in_z LPCWSTR wzVariable,
__in LONGLONG llValue
);
/*******************************************************************
BalVariableExists - checks if a variable exists in the engine.
********************************************************************/
DAPI_(BOOL) BalVariableExists(
__in_z LPCWSTR wzVariable
);
/*******************************************************************
BalGetStringVariable - gets a string from a variable in the engine.
Note: Use StrFree() to release psczValue.
********************************************************************/
DAPI_(HRESULT) BalGetStringVariable(
__in_z LPCWSTR wzVariable,
__inout LPWSTR* psczValue
);
/*******************************************************************
BalSetStringVariable - sets a string variable in the engine.
********************************************************************/
DAPI_(HRESULT) BalSetStringVariable(
__in_z LPCWSTR wzVariable,
__in_z_opt LPCWSTR wzValue,
__in BOOL fFormatted
);
/*******************************************************************
BalLog - logs a message with the engine.
********************************************************************/
DAPIV_(HRESULT) BalLog(
__in BOOTSTRAPPER_LOG_LEVEL level,
__in_z __format_string LPCSTR szFormat,
...
);
/*******************************************************************
BalLogArgs - logs a message with the engine.
********************************************************************/
DAPI_(HRESULT) BalLogArgs(
__in BOOTSTRAPPER_LOG_LEVEL level,
__in_z __format_string LPCSTR szFormat,
__in va_list args
);
/*******************************************************************
BalLogError - logs an error message with the engine.
********************************************************************/
DAPIV_(HRESULT) BalLogError(
__in HRESULT hr,
__in_z __format_string LPCSTR szFormat,
...
);
/*******************************************************************
BalLogErrorArgs - logs an error message with the engine.
********************************************************************/
DAPI_(HRESULT) BalLogErrorArgs(
__in HRESULT hr,
__in_z __format_string LPCSTR szFormat,
__in va_list args
);
/*******************************************************************
BalLogId - logs a message with the engine with a string embedded in a
MESSAGETABLE resource.
********************************************************************/
DAPIV_(HRESULT) BalLogId(
__in BOOTSTRAPPER_LOG_LEVEL level,
__in DWORD dwLogId,
__in HMODULE hModule,
...
);
DAPI_(HRESULT) BalLogIdArgs(
__in BOOTSTRAPPER_LOG_LEVEL level,
__in DWORD dwLogId,
__in HMODULE hModule,
__in va_list args
);
#ifdef __cplusplus
}
#endif
|
