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
|
/*
* sadapi.h
*
* Copyright (c) Microsoft Corp. 1986-1996. All Rights Reserved.
*
* Definition of the public RPC APIs from the SAD Exchange service
*
*/
#ifndef _SADLIB_H_
#define _SADLIB_H_
#include <rpcpub.h>
#ifdef __cplusplus
extern "C"
{
#endif
/*
* Return codes for all functions except SAD_EcGetProxies() and SAD_EcGetProxiesBI().
* In addition to this list are all normal NT error codes...
*/
typedef enum _SC_RETURN_VALUES
{
SC_OK = 0, // no error
SC_Error = 49001, // general error
SC_BPActive, // bulk proxy generation is currently running
SC_BPInactive, // bulk proxy generation is not currently running
SC_BPShutdownPending, // a shutdown in bulk proxy generation is in progress
SC_BPSiteAddressMismatch, // a Site Address Mismatch between rgszOldSiteAddress
// and rgszNewSiteAddress lists in ScBulkUpdateMultiProxy
} SC_RETURN_VALUES;
#define cchMaxServer (MAX_COMPUTERNAME_LENGTH + 1)
typedef struct _RPCBINDINFO
{
handle_t h;
WCHAR wszServer[cchMaxServer];
RPC_IF_HANDLE hClientIfHandle;
} RPCBINDINFO, *PRPCBINDINFO;
// Utility entry points
RPC_SC WINAPI SAD_ScBindA(PRPCBINDINFO pBI, LPSTR szServer);
RPC_SC WINAPI SAD_ScBindW(PRPCBINDINFO pBI, LPWSTR wszServer);
void WINAPI SAD_Unbind(PRPCBINDINFO pBI);
#ifdef UNICODE
#define SAD_ScBind SAD_ScBindW
#else
#define SAD_ScBind SAD_ScBindA
#endif
// Message Tracking group
RPC_SC WINAPI SAD_ScSaveGatewayTrackingData(PRPCBINDINFO pBI,
RPC_GATEWAY_TRACK_INFORMATION * pgti,
INT cszRecipients,
LPWSTR rgwszRecipients[]);
// for Microsoft Internal Use ONLY
RPC_SC WINAPI SAD_ScSaveTrackingData(PRPCBINDINFO pBI, INT cb, BYTE pb[], DWORD dwFlags);
// for Gateways - cause the routing table to be recalculated
RPC_SC WINAPI SAD_ScRunRIDA(LPSTR szServer);
RPC_SC WINAPI SAD_ScRunRIDW(LPWSTR wszServer);
RPC_SC WINAPI SAD_ScRunRIDExA(LPSTR szServer, RPC_BOOL fProxySpace, RPC_BOOL fGwart);
RPC_SC WINAPI SAD_ScRunRIDExW(LPWSTR wszServer, RPC_BOOL fProxySpace, RPC_BOOL fGwart);
#ifdef UNICODE
#define SAD_ScRunRID SAD_ScRunRIDW
#define SAD_ScRunRIDEx SAD_ScRunRIDExW
#else
#define SAD_ScRunRID SAD_ScRunRIDA
#define SAD_ScRunRIDEx SAD_ScRunRIDExA
#endif
// Proxy Entry points
RPC_EC WINAPI SAD_EcGetProxies(LPWSTR wszServer, PPROXYINFO pProxyInfo, PPROXYLIST pProxyList);
RPC_EC WINAPI SAD_EcGetProxiesBI(PRPCBINDINFO pBI, PPROXYINFO pProxyInfo, PPROXYLIST pProxyList);
void WINAPI SAD_FreeProxyListNode(PPROXYNODE pnode);
RPC_SC WINAPI SAD_ScIsProxyUniqueA(LPSTR szServer,
LPSTR szProxy, RPC_BOOL * pfUnique, LPSTR * pszExisting);
RPC_SC WINAPI SAD_ScIsProxyUniqueW(LPWSTR wszServer,
LPWSTR szProxy, RPC_BOOL * pfUnique, LPWSTR * pszExisting);
// dwOptions values for SAD_ScBulkCreateProxy() and SAD_ScBulkCreateMultiProxy()
#define BPTAdd 1
#define BPTRemove 2
#define BPTUpdate 3
RPC_SC WINAPI SAD_ScBulkCreateProxyA(LPSTR szServer, LPSTR szHeader, DWORD dwOptions);
RPC_SC WINAPI SAD_ScBulkCreateProxyW(LPWSTR wszServer, LPWSTR wszHeader, DWORD dwOptions);
RPC_SC WINAPI SAD_ScBulkCreateMultiProxyA(LPSTR szServer,
INT cszHeader,
LPSTR rgszHeader[],
DWORD dwOptions);
RPC_SC WINAPI SAD_ScBulkCreateMultiProxyW(LPWSTR wszServer,
INT cwszHeader,
LPWSTR rgwszHeader[],
DWORD dwOptions);
RPC_SC WINAPI SAD_ScBulkUpdateMultiProxy(LPWSTR wszServer,
INT cwszSiteAddress,
LPWSTR rgwszOldSiteAddress[],
LPWSTR rgwszNewSiteAddress[],
RPC_BOOL fSaveSiteAddress);
RPC_SC WINAPI SAD_ScGetBulkProxyStatusA(LPSTR szServer,
RPC_SYSTEMTIME * pstTimeStart,
DWORD * pdwTimeStart,
DWORD * pdwTimeCur,
INT * piRecipients,
INT * pcRecipients);
RPC_SC WINAPI SAD_ScGetBulkProxyStatusW(LPWSTR wszServer,
RPC_SYSTEMTIME * pstTimeStart,
DWORD * pdwTimeStart,
DWORD * pdwTimeCur,
INT * piRecipients,
INT * pcRecipients);
RPC_SC WINAPI SAD_ScBulkProxyHaltA(LPSTR szServer, RPC_BOOL fWaitForShutdown);
RPC_SC WINAPI SAD_ScBulkProxyHaltW(LPWSTR wszServer, RPC_BOOL fWaitForShutdown);
#ifdef UNICODE
#define SAD_ScIsProxyUnique SAD_ScIsProxyUniqueW
#define SAD_ScBulkCreateProxy SAD_ScBulkCreateProxyW
#define SAD_ScBulkCreateMultiProxy SAD_ScBulkCreateMultiProxyW
#define SAD_ScGetBulkProxyStatus SAD_ScGetBulkProxyStatusW
#define SAD_ScBulkProxyHalt SAD_ScBulkProxyHaltW
#else
#define SAD_ScIsProxyUnique SAD_ScIsProxyUniqueA
#define SAD_ScBulkCreateProxy SAD_ScBulkCreateProxyA
#define SAD_ScBulkCreateMultiProxy SAD_ScBulkCreateMultiProxyA
#define SAD_ScGetBulkProxyStatus SAD_ScGetBulkProxyStatusA
#define SAD_ScBulkProxyHalt SAD_ScBulkProxyHaltA
#endif
// Backup entry point (available only in UNICODE!)
RPC_SC WINAPI SAD_ScGetBackupListNodeW(LPWSTR wszServer, BackupListNode ** ppnode);
void WINAPI SAD_FreeBackupListNode(BackupListNode * pnode);
// Run DRA Check calling parameters (dwCheck)
#define INTRASITE_CHECK 0
#define INTERSITE_CHECK 1
RPC_SC WINAPI SAD_ScRunDRACheck(LPWSTR wszServer, RPC_DWORD dwCheck);
// These few lines (or equivalent) need to be supplied by the application that links
// with SADAPI.LIB.
#ifdef _SAMPLE_CODE
void __RPC_FAR * __RPC_API midl_user_allocate(size_t cb)
{
void * pv;
pv = GlobalAlloc(GMEM_FIXED, cb);
if (!pv)
RpcRaiseException(RPC_S_OUT_OF_MEMORY);
return pv;
}
void __RPC_API midl_user_free(void __RPC_FAR * pv)
{
GlobalFree(pv);
}
#endif
#ifdef __cplusplus
}
#endif
#endif // #ifndef _SADLIB_H_
|
