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
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
|
/*++
Copyright (c) 1991-1993 Microsoft Corporation
Module Name:
RxP.h
Abstract:
This is the private header file for the NT version of RpcXlate.
Author:
John Rogers (JohnRo) 25-Mar-1991
Environment:
Portable to any flat, 32-bit environment. (Uses Win32 typedefs.)
Requires ANSI C extensions: slash-slash comments, long external names.
Revision History:
25-Mar-1991 JohnRo
Created.
03-May-1991 JohnRo
RxpStartBuildingTransaction's data descriptor is SMB version (no Q's
or U's). RxpConvertBlock needs 2 versions of data descriptor.
RcvDataPtrPtr and RcvDataPresent are redundant for RxpConvertArguments
and RxpConvertBlock. RxpTransactSmb now gets UNC server name.
Fixed receive buffer size problem. Use LPTSTR.
Added stuff to allow runtime debug on/off changes.
Clarify that RxpStartBuildingTransaction uses buffer as OUT.
Reduced recompile hits from header files.
06-May-1991 JohnRo
Added RxpComputeRequestBufferSize().
13-May-1991 JohnRo
Added print Q and print job APIs support.
14-May-1991 JohnRo
Pass 2 aux descriptors to RxpConvertBlock. Clarify other types of
aux descriptors.
18-May-1991 JohnRo
Handle array of aux structs.
19-May-1991 JohnRo
Added DBGSTATIC definition. Pass ResourceName to RxpSetField().
Fixed RxpAddAscii().
20-May-1991 JohnRo
Make data descriptors OPTIONAL for RxpConvertBlock.
29-May-1991 JohnRo
RxpConvertArgs must return SendDataPtr16 and SendDataSize16.
05-Jun-1991 JohnRo
Added setfield debug output.
11-Jun-1991 rfirth
Added SmbRcvByteLen parameter to RxpConvertBlock
Changed RetDataSize parameter to RxpTransactSmb to IN OUT LPDWORD
12-Jun-1991 JohnRo
Moved DBGSTATIC to <NetDebug.h>.
13-Jun-1991 JohnRo
RxpPackSendBuffer and RxpConvertArgs both need DataDesc16.
15-Jul-1991 JohnRo
Added FieldIndex parameter to RxpSetField.
Changed RxpConvertDataStructures to allow ERROR_MORE_DATA, e.g. for
print APIs. Added debug flag for the same routine.
16-Jul-1991 JohnRo
Estimate bytes needed for print APIs.
17-Jul-1991 JohnRo
Extracted RxpDebug.h from Rxp.h.
19-Aug-1991 rfirth
Added Flags parameter to RxpConvert{Args|Block}
04-Oct-1991 JohnRo
Handle ERROR_BAD_NET_NAME (e.g. IPC$ not shared) to fix NetShareEnum.
More work toward UNICODE. (Added RxpAddTStr().)
07-Oct-1991 JohnRo
Made changes suggested by PC-LINT.
24-Oct-1991 JohnRo
Added RxpCopyStrArrayToTStrArray for remote config and disk enum.
29-Oct-1991 JohnRo
RxpFatalErrorCode() should be paranoid.
13-Nov-1991 JohnRo
OK, RxpFatalErrorCode() was too paranoid. It should allow
ERROR_MORE_DATA or all the enum APIs break.
31-Mar-1992 JohnRo
Prevent too large size requests.
05-Jun-1992 JohnRo
RAID 11253: NetConfigGetAll fails when remoted to downlevel.
26-Jun-1992 JohnRo
RAID 9933: ALIGN_WORST should be 8 for x86 builds.
04-May-1993 JohnRo
RAID 6167: avoid access violation or assert with WFW print server.
Made changes suggested by PC-LINT 5.0
18-May-1993 JohnRo
DosPrintQGetInfoW underestimates number of bytes needed.
--*/
#ifndef _RXP_
#define _RXP_
// These must be included first:
#include <windef.h> // IN, LPTSTR, LPVOID, etc.
#include <lmcons.h> // NET_API_STATUS.
// These may be included in any order:
#include <rap.h> // LPDESC, RapStructureSize(), etc.
// Don't complain about "unneeded" includes of these files:
/*lint -efile(764,rxp.h,smbgtpt.h,stdarg.h,tstr.h,tstring.h) */
/*lint -efile(766,rxp.h,smbgtpt.h,stdarg.h,tstr.h,tstring.h) */
#include <smbgtpt.h> // SmbPutUshort() (needed by macros below).
#include <stdarg.h> // va_list, etc.
#include <tstring.h> // NetpCopyTStrToStr().
// Maximum sizes (in bytes) supported by the transact SMB.
#define MAX_TRANSACT_RET_DATA_SIZE ((DWORD) 0x0000FFFF)
#define MAX_TRANSACT_RET_PARM_SIZE ((DWORD) 0x0000FFFF)
#define MAX_TRANSACT_SEND_DATA_SIZE ((DWORD) 0x0000FFFF)
#define MAX_TRANSACT_SEND_PARM_SIZE ((DWORD) 0x0000FFFF)
// Note: IF_DEBUG() and so on are now in Net/Inc/RxpDebug.h.
DWORD
RxpComputeRequestBufferSize(
IN LPDESC ParmDesc,
IN LPDESC DataDescSmb OPTIONAL,
IN DWORD DataSize
);
NET_API_STATUS
RxpConvertArgs(
IN LPDESC ParmDescriptorString,
IN LPDESC DataDesc16 OPTIONAL,
IN LPDESC DataDesc32 OPTIONAL,
IN LPDESC DataDescSmb OPTIONAL,
IN LPDESC AuxDesc16 OPTIONAL,
IN LPDESC AuxDesc32 OPTIONAL,
IN LPDESC AuxDescSmb OPTIONAL,
IN DWORD MaximumInputBlockSize,
IN DWORD MaximumOutputBlockSize,
IN OUT LPDWORD CurrentInputBlockSizePtr,
IN OUT LPDWORD CurrentOutputBlockSizePtr,
IN OUT LPBYTE * CurrentOutputBlockPtrPtr,
IN va_list * FirstArgumentPtr, // rest of API's arguments (after
// server name)
OUT LPDWORD SendDataSizePtr16,
OUT LPBYTE * SendDataPtrPtr16,
OUT LPDWORD RcvDataSizePtr,
OUT LPBYTE * RcvDataPtrPtr,
IN DWORD Flags
);
NET_API_STATUS
RxpConvertBlock(
IN DWORD ApiNumber,
IN LPBYTE ResponseBlockPtr,
IN LPDESC ParmDescriptorString,
IN LPDESC DataDescriptor16 OPTIONAL,
IN LPDESC DataDescriptor32 OPTIONAL,
IN LPDESC AuxDesc16 OPTIONAL,
IN LPDESC AuxDesc32 OPTIONAL,
IN va_list* FirstArgumentPtr, // rest of API's arguments
IN LPBYTE SmbRcvBuffer OPTIONAL,
IN DWORD SmbRcvByteLen,
OUT LPBYTE RcvDataPtr OPTIONAL,
IN DWORD RcvDataSize,
IN DWORD Flags
);
// DWORD
// RxpEstimateBytesNeeded(
// IN DWORD BytesNeeded16
// );
//
// Worst case: BOOL or CHAR might be padded to DWORD.
#define RxpEstimateBytesNeeded(Size16) \
( (Size16) * 4 )
//
// Estimate bytes needed for an audit log or error log array.
//
NET_API_STATUS
RxpEstimateLogSize(
IN DWORD DownlevelFixedEntrySize,
IN DWORD InputArraySize,
IN BOOL DoingErrorLog, // TRUE for error log, FALSE for audit log
OUT LPDWORD OutputArraySize
);
// BOOL
// RxpFatalErrorCode(
// IN NET_API_STATUS Status
// );
//
#define RxpFatalErrorCode( Status ) \
( ( ((Status) != NERR_Success) \
&& ((Status) != ERROR_MORE_DATA) ) \
? TRUE : FALSE )
NET_API_STATUS
RxpPackSendBuffer(
IN OUT LPVOID * SendBufferPtrPtr,
IN OUT LPDWORD SendBufferSizePtr,
OUT LPBOOL AllocFlagPtr,
IN LPDESC DataDesc16,
IN LPDESC AuxDesc16,
IN DWORD FixedSize16,
IN DWORD AuxOffset,
IN DWORD AuxSize,
IN BOOL SetInfo
);
NET_API_STATUS
RxpReceiveBufferConvert(
IN OUT LPVOID RcvDataPtr,
IN DWORD RcvDataSize,
IN DWORD Converter,
IN DWORD NumberOfStructures,
IN LPDESC DataDescriptorString,
IN LPDESC AuxDescriptorString,
OUT LPDWORD NumAuxStructs
);
NET_API_STATUS
RxpSetField (
IN DWORD ApiNumber,
IN LPTSTR UncServerName,
IN LPDESC ObjectDesc OPTIONAL,
IN LPVOID ObjectToSet OPTIONAL,
IN LPDESC ParmDesc,
IN LPDESC DataDesc16,
IN LPDESC DataDesc32,
IN LPDESC DataDescSmb,
IN LPVOID NativeInfoBuffer,
IN DWORD ParmNumToSend,
IN DWORD FieldIndex,
IN DWORD Level
);
NET_API_STATUS
RxpStartBuildingTransaction(
OUT LPVOID Buffer,
IN DWORD BufferSize,
IN DWORD ApiNumber,
IN LPDESC ParmDesc,
IN LPDESC DataDescSmb OPTIONAL,
OUT LPVOID * RovingOutputPtr,
OUT LPDWORD SizeSoFarPtr,
OUT LPVOID * LastStringPtr OPTIONAL,
OUT LPDESC * ParmDescCopyPtr OPTIONAL
);
NET_API_STATUS
RxpTransactSmb(
IN LPTSTR UncServerName,
IN LPTSTR TransportName,
IN LPVOID SendParmPtr,
IN DWORD SendParmSize,
IN LPVOID SendDataPtr OPTIONAL,
IN DWORD SendDataSize,
OUT LPVOID RetParmPtr OPTIONAL,
IN DWORD RetParmSize,
OUT LPVOID RetDataPtr OPTIONAL,
IN OUT LPDWORD RetDataSize,
IN BOOL NoPermissionRequired
);
NET_API_STATUS
RxpConvertDataStructures(
IN LPDESC InputDescriptor,
IN LPDESC OutputDescriptor,
IN LPDESC InputAuxDescriptor OPTIONAL,
IN LPDESC OutputAuxDescriptor OPTIONAL,
IN LPBYTE InputBuffer,
OUT LPBYTE OutputBuffer,
IN DWORD OutputBufferSize,
IN DWORD PrimaryCount,
OUT LPDWORD EntriesConverted OPTIONAL,
IN RAP_TRANSMISSION_MODE TransmissionMode,
IN RAP_CONVERSION_MODE ConversionMode
);
// BUGBUG: For the macros below, does it matter whether we store pointer or
// offset in buffer?
// VOID
// RxpAddPointer(
// IN LPVOID Input,
// IN OUT LPBYTE * CurPtrPtr,
// IN OUT LPDWORD CurSizePtr
// );
//
#define RxpAddPointer(Input,CurPtrPtr,CurSizePtr) \
{ \
SmbPutUlong( (LPDWORD) *(CurPtrPtr), (DWORD) (Input)); \
*(CurPtrPtr) += sizeof(LPBYTE); \
*(CurSizePtr) = (*(CurSizePtr)) + sizeof(LPBYTE); \
}
// RxpAddVariableSize: Add a variable length item to string space at end of
// buffer. Store pointer to it in buffer; update current buffer pointer and
// Size; update string space pointer.
// BUGBUG: Check for overflow!
//
// VOID
// RxpAddVariableSize(
// IN LPBYTE Input,
// IN DWORD InputSize,
// IN OUT LPBYTE * CurPtrPtr,
// IN OUT LPBYTE * StrPtrPtr,
// IN OUT LPDWORD CurSizePtr
// );
//
#define RxpAddVariableSize(Input,InputSize,CurPtrPtr,StrPtrPtr,CurSizePtr) \
{ \
*(StrPtrPtr) -= (InputSize); \
RxpAddPointer( *(StrPtrPtr), (CurPtrPtr), (CurSizePtr)); \
NetpMoveMemory( *((StrPtrPtr)), (Input), (InputSize)); \
}
// RxpAddAscii: Add an ASCII string to string space at end of buffer;
// store pointer to it in buffer; update current buffer pointer and Size;
// update string space pointer.
// BUGBUG: Check for overflow!
//
// VOID
// RxpAddAscii(
// IN LPTSTR Input,
// IN OUT LPBYTE * CurPtrPtr,
// IN OUT LPBYTE * StrPtrPtr,
// IN OUT LPDWORD CurSizePtr
// );
//
#define RxpAddAscii(Input,CurPtrPtr,StrPtrPtr,CurSizePtr) \
{ \
DWORD len = strlen((Input))+1; \
RxpAddVariableSize( \
(Input), len, \
(CurPtrPtr), (StrPtrPtr), (CurSizePtr)); \
}
// RxpAddTStr: Add a LPTSTR string to string space at end of buffer;
// store pointer to it in buffer; update current buffer pointer and Size;
// update string space pointer.
// BUGBUG: Check for overflow!
//
// VOID
// RxpAddTStr(
// IN LPTSTR Input,
// IN OUT LPBYTE * CurPtrPtr,
// IN OUT LPBYTE * StrPtrPtr,
// IN OUT LPDWORD CurSizePtr
// );
//
#define RxpAddTStr(Input,CurPtrPtr,StrPtrPtr,CurSizePtr) \
{ \
DWORD size = STRLEN((Input))+1; \
*(StrPtrPtr) -= size; \
RxpAddPointer( *(StrPtrPtr), (CurPtrPtr), (CurSizePtr)); \
NetpCopyTStrToStr( *((StrPtrPtr)), (Input) ); \
}
// VOID
// RxpAddWord(
// IN WORD Input,
// IN OUT LPBYTE * CurPtrPtr,
// IN OUT LPDWORD CurSizePtr
// );
//
#define RxpAddWord(Input,CurPtrPtr,CurSizePtr) \
{ \
SmbPutUshort( (LPWORD) (*(CurPtrPtr)), (WORD) (Input)); \
*(CurPtrPtr) += sizeof(WORD); \
*(CurSizePtr) = (*(CurSizePtr)) + sizeof(WORD); \
}
//
// MAKE_PARMNUM_PAIR() - packs a parmnum and a field index into a DWORD. We
// have to do this because there are (many) cases where we cannot assume
// correspondence between a parmnum and a field index
//
#define MAKE_PARMNUM_PAIR(parmnum, field_index) ((DWORD)((((DWORD)(field_index)) << 16) | (DWORD)(parmnum)))
//
// FIELD_INDEX_FROM_PARMNUM_PAIR() - retrieve the field index from the pair
// conjoined by MAKE_PARMNUM_PAIR()
//
#define FIELD_INDEX_FROM_PARMNUM_PAIR(pair) ((DWORD)((pair) >> 16))
//
// PARMNUM_FROM_PARMNUM_PAIR() - retrieve the parmnum from the pair conjoined
// by MAKE_PARMNUM_PAIR()
//
#define PARMNUM_FROM_PARMNUM_PAIR(pair) ((DWORD)((pair) & 0x0000ffff))
#endif // ndef _RXP_
|