check return value before using key_values
[Samba.git] / librpc / idl / drsuapi.idl
blobcd90500faf57c4c9362e144b17b0ed4d59b57d09
1 #include "idl_types.h"
3 import "security.idl", "misc.idl", "lsa.idl", "samr.idl";
6 uuid("e3514235-4b06-11d1-ab04-00c04fc2dcd2"),
7 version(4.0),
8 endpoint("ncacn_np:[\\pipe\\lsass]","ncacn_np:[\\pipe\\protected_storage]", "ncacn_ip_tcp:", "ncalrpc:"),
9 authservice("ldap"),
10 helpstring("Active Directory Replication"),
11 helper("../librpc/ndr/ndr_drsuapi.h"),
12 pointer_default(unique)
14 interface drsuapi
16 typedef bitmap samr_GroupAttrs samr_GroupAttrs;
18 /* see MS-DRSR section 5.39 */
19 typedef [public,bitmap32bit] bitmap {
20 DRSUAPI_DRS_ASYNC_OP = 0x00000001,
21 DRSUAPI_DRS_GETCHG_CHECK = 0x00000002,
22 DRSUAPI_DRS_UPDATE_NOTIFICATION = 0x00000002,
23 DRSUAPI_DRS_ADD_REF = 0x00000004,
24 DRSUAPI_DRS_SYNC_ALL = 0x00000008,
25 DRSUAPI_DRS_DEL_REF = 0x00000008,
26 DRSUAPI_DRS_WRIT_REP = 0x00000010,
27 DRSUAPI_DRS_INIT_SYNC = 0x00000020,
28 DRSUAPI_DRS_PER_SYNC = 0x00000040,
29 DRSUAPI_DRS_MAIL_REP = 0x00000080,
30 DRSUAPI_DRS_ASYNC_REP = 0x00000100,
31 DRSUAPI_DRS_IGNORE_ERROR = 0x00000100,
32 DRSUAPI_DRS_TWOWAY_SYNC = 0x00000200,
33 DRSUAPI_DRS_CRITICAL_ONLY = 0x00000400,
34 DRSUAPI_DRS_GET_ANC = 0x00000800,
35 DRSUAPI_DRS_GET_NC_SIZE = 0x00001000,
36 DRSUAPI_DRS_LOCAL_ONLY = 0x00001000,
37 DRSUAPI_DRS_NONGC_RO_REP = 0x00002000,
38 DRSUAPI_DRS_SYNC_BYNAME = 0x00004000,
39 DRSUAPI_DRS_REF_OK = 0x00004000,
40 DRSUAPI_DRS_FULL_SYNC_NOW = 0x00008000,
41 DRSUAPI_DRS_NO_SOURCE = 0x00008000,
42 DRSUAPI_DRS_FULL_SYNC_IN_PROGRESS = 0x00010000,
43 DRSUAPI_DRS_FULL_SYNC_PACKET = 0x00020000,
44 DRSUAPI_DRS_SYNC_REQUEUE = 0x00040000,
45 DRSUAPI_DRS_SYNC_URGENT = 0x00080000,
46 DRSUAPI_DRS_REF_GCSPN = 0x00100000,
47 DRSUAPI_DRS_NO_DISCARD = 0x00100000,
48 DRSUAPI_DRS_NEVER_SYNCED = 0x00200000,
49 DRSUAPI_DRS_SPECIAL_SECRET_PROCESSING = 0x00400000,
50 DRSUAPI_DRS_INIT_SYNC_NOW = 0x00800000,
51 DRSUAPI_DRS_PREEMPTED = 0x01000000,
52 DRSUAPI_DRS_SYNC_FORCED = 0x02000000,
53 DRSUAPI_DRS_DISABLE_AUTO_SYNC = 0x04000000,
54 DRSUAPI_DRS_DISABLE_PERIODIC_SYNC = 0x08000000,
55 DRSUAPI_DRS_USE_COMPRESSION = 0x10000000,
56 DRSUAPI_DRS_NEVER_NOTIFY = 0x20000000,
57 DRSUAPI_DRS_SYNC_PAS = 0x40000000,
58 DRSUAPI_DRS_GET_ALL_GROUP_MEMBERSHIP = 0x80000000
59 } drsuapi_DrsOptions;
61 typedef [public,bitmap32bit] bitmap {
62 DRSUAPI_DRS_GET_TGT = 0x00000001
63 } drsuapi_DrsMoreOptions;
65 /* see DRS_MSG_REPMOD_V1 */
66 typedef [public,bitmap32bit] bitmap {
67 DRSUAPI_DRS_UPDATE_FLAGS = 0x00000001,
68 DRSUAPI_DRS_UPDATE_ADDRESS = 0x00000002,
69 DRSUAPI_DRS_UPDATE_SCHEDULE = 0x00000004
70 } drsuapi_DrsUpdate;
72 /*****************/
73 /* Function 0x00 drsuapi_DsBind() */
75 /* MS-DRSR 5.39 DRS_EXTENSIONS_INT */
76 typedef [bitmap32bit] bitmap {
77 DRSUAPI_SUPPORTED_EXTENSION_BASE = 0x00000001,
78 DRSUAPI_SUPPORTED_EXTENSION_ASYNC_REPLICATION = 0x00000002,
79 DRSUAPI_SUPPORTED_EXTENSION_REMOVEAPI = 0x00000004,
80 DRSUAPI_SUPPORTED_EXTENSION_MOVEREQ_V2 = 0x00000008,
81 DRSUAPI_SUPPORTED_EXTENSION_GETCHG_COMPRESS = 0x00000010,
82 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V1 = 0x00000020,
83 DRSUAPI_SUPPORTED_EXTENSION_RESTORE_USN_OPTIMIZATION = 0x00000040,
84 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY = 0x00000080,
85 DRSUAPI_SUPPORTED_EXTENSION_KCC_EXECUTE = 0x00000100,
86 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY_V2 = 0x00000200,
87 DRSUAPI_SUPPORTED_EXTENSION_LINKED_VALUE_REPLICATION = 0x00000400,
88 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V2 = 0x00000800,
89 DRSUAPI_SUPPORTED_EXTENSION_INSTANCE_TYPE_NOT_REQ_ON_MOD= 0x00001000,
90 DRSUAPI_SUPPORTED_EXTENSION_CRYPTO_BIND = 0x00002000,
91 DRSUAPI_SUPPORTED_EXTENSION_GET_REPL_INFO = 0x00004000,
92 DRSUAPI_SUPPORTED_EXTENSION_STRONG_ENCRYPTION = 0x00008000,
93 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V01 = 0x00010000,
94 DRSUAPI_SUPPORTED_EXTENSION_TRANSITIVE_MEMBERSHIP = 0x00020000,
95 DRSUAPI_SUPPORTED_EXTENSION_ADD_SID_HISTORY = 0x00040000,
96 DRSUAPI_SUPPORTED_EXTENSION_POST_BETA3 = 0x00080000,
97 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V5 = 0x00100000,
98 DRSUAPI_SUPPORTED_EXTENSION_GET_MEMBERSHIPS2 = 0x00200000,
99 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V6 = 0x00400000,
100 DRSUAPI_SUPPORTED_EXTENSION_NONDOMAIN_NCS = 0x00800000,
101 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V8 = 0x01000000,
102 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V5 = 0x02000000,
103 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V6 = 0x04000000,
105 * the following 3 have the same value
106 * repadmin.exe /bind says that
108 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRYREPLY_V3 = 0x08000000,
109 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V7 = 0x08000000,
110 DRSUAPI_SUPPORTED_EXTENSION_VERIFY_OBJECT = 0x08000000,
111 DRSUAPI_SUPPORTED_EXTENSION_XPRESS_COMPRESS = 0x10000000,
112 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V10 = 0x20000000,
113 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART2 = 0x40000000,
114 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART3 = 0x80000000
115 } drsuapi_SupportedExtensions;
117 typedef [bitmap32bit] bitmap {
118 DRSUAPI_SUPPORTED_EXTENSION_ADAM = 0x00000001,
119 DRSUAPI_SUPPORTED_EXTENSION_LH_BETA2 = 0x00000002,
120 DRSUAPI_SUPPORTED_EXTENSION_RECYCLE_BIN = 0x00000004
121 } drsuapi_SupportedExtensionsExt;
123 /* this is used by w2k */
124 typedef [public] struct {
125 drsuapi_SupportedExtensions supported_extensions;
126 GUID site_guid;
127 uint32 pid;
128 } drsuapi_DsBindInfo24;
130 /* this is used by w2k3 */
131 typedef [public] struct {
132 drsuapi_SupportedExtensions supported_extensions;
133 GUID site_guid;
134 uint32 pid;
135 uint32 repl_epoch;
136 } drsuapi_DsBindInfo28;
138 typedef [public] struct {
139 drsuapi_SupportedExtensions supported_extensions;
140 GUID site_guid;
141 uint32 pid;
142 uint32 repl_epoch;
143 drsuapi_SupportedExtensionsExt supported_extensions_ext;
144 } drsuapi_DsBindInfo32;
146 /* this is used by w2k8 */
147 typedef [public] struct {
148 drsuapi_SupportedExtensions supported_extensions;
149 GUID site_guid;
150 uint32 pid;
151 uint32 repl_epoch;
152 drsuapi_SupportedExtensionsExt supported_extensions_ext;
153 GUID config_dn_guid;
154 } drsuapi_DsBindInfo48;
156 /* this is used by w2k12 R2 [MS-DRSR] Section 5.39 */
157 typedef [public] struct {
158 drsuapi_SupportedExtensions supported_extensions;
159 GUID site_guid;
160 uint32 pid;
161 uint32 repl_epoch;
162 drsuapi_SupportedExtensionsExt supported_extensions_ext;
163 GUID config_dn_guid;
164 drsuapi_SupportedExtensionsExt supported_capabilities_ext;
165 } drsuapi_DsBindInfo52;
167 typedef [public] struct {
168 [flag(NDR_REMAINING)] DATA_BLOB info;
169 } drsuapi_DsBindInfoFallBack;
171 typedef [nopull, nopush, noprint] [nodiscriminant] union {
172 [case(24)][subcontext(0), subcontext_size(24)] drsuapi_DsBindInfo24 info24;
173 [case(28)][subcontext(0), subcontext_size(28)] drsuapi_DsBindInfo28 info28;
174 [case(32)][subcontext(0), subcontext_size(32)] drsuapi_DsBindInfo32 info32;
175 [case(48)][subcontext(0), subcontext_size(48)] drsuapi_DsBindInfo48 info48;
176 [case(52)][subcontext(0), subcontext_size(52)] drsuapi_DsBindInfo52 info52;
178 * The size for the defaut case is a bit arbitrary it in fact the value
179 * of the switch but we can't reference it.
180 * As we hand(un-)marshall this structure it has 0 impact and makes
181 * pidl happy for wireshark too
183 [default][subcontext(0), subcontext_size(48)] drsuapi_DsBindInfoFallBack Fallback;
184 } drsuapi_DsBindInfo;
186 /* the drsuapi_DsBindInfoCtr was this before
187 * typedef [flag(NDR_PAHEX)] struct {
188 * [range(1,10000)] uint32 length;
189 * [size_is(length)] uint8 data[];
190 * } drsuapi_DsBindInfo;
192 * but we don't want the caller to manually decode this blob,
193 * so we're doing it here
197 * MS-DRSR.pdf gives the following definition
198 typedef struct {
199 [range(1,10000)] DWORD cb;
200 [size_is(cb)] BYTE rgb[];
201 } DRS_EXTENSIONS;
203 But we use a subcontext which has a slighly different signification on how
204 data are laid out.
205 With the MS-DRSR definition we will have
206 size_is_cb cv rgb_array
207 with size_is_cb being a uint3264 and cv being a uint32
209 We used to have
210 typedef struct {
211 [range(1,10000)] uint32 length;
212 [switch_is(length)] drsuapi_DsBindInfo info;
213 } drsuapi_DsBindInfoCtr;
215 typedef [nodiscriminant] union {
216 [case(24)][subcontext(4)] drsuapi_DsBindInfo24 info24;
217 [case(28)][subcontext(4)] drsuapi_DsBindInfo28 info28;
218 [case(48)][subcontext(4)] drsuapi_DsBindInfo48 info48;
219 [default][subcontext(4)] drsuapi_DsBindInfoFallBack FallBack;
220 } drsuapi_DsBindInfo;
222 With this definition data is laid out this way:
223 length subcontext_size drsuapi_DsBindInfoxx
224 with length being a uint32 and subcontext_size being a uint3264
226 It has clearly an impact on the way things are aligned when using NDR64
228 typedef [flag(NDR_NOALIGN)] struct {
229 [range(1,10000)] uint3264 length;
230 [value(length)] uint32 __ndr_length;
231 [switch_is(length)] drsuapi_DsBindInfo info;
232 } drsuapi_DsBindInfoCtr;
234 /* this is a magic guid you need to pass to DsBind to make drsuapi_DsWriteAccountSpn() work
236 * maybe the bind_guid could also be the invocation_id see drsuapi_DsReplicaConnection04
238 const char *DRSUAPI_DS_BIND_GUID = "e24d201a-4fd6-11d1-a3da-0000f875ae0d";
240 * this magic guid are needed to fetch the whole tree with drsuapi_DsGetNCChanges()
241 * as administrator and this values are also used in the destination_dsa_guid field
242 * of drsuapi_DsGetNCChangesReq5/8 and the source_dsa_guid is zero.
244 const char *DRSUAPI_DS_BIND_GUID_W2K = "6abec3d1-3054-41c8-a362-5a0c5b7d5d71";
245 const char *DRSUAPI_DS_BIND_GUID_W2K3 = "6afab99c-6e26-464a-975f-f58f105218bc";
247 [public] WERROR drsuapi_DsBind(
248 [in,unique] GUID *bind_guid,
249 [in,out,unique] drsuapi_DsBindInfoCtr *bind_info,
250 [out] policy_handle *bind_handle
253 /*****************/
254 /* Function 0x01 */
255 WERROR drsuapi_DsUnbind(
256 [in,out] policy_handle *bind_handle
259 /*****************/
260 /* Function 0x02 */
261 typedef [public,gensize] struct {
262 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier(r, ndr->flags)-4)] uint32 __ndr_size;
263 [value(ndr_size_dom_sid28(&sid, ndr->flags))] uint32 __ndr_size_sid;
264 GUID guid;
265 dom_sid28 sid;
266 [value(strlen_m(dn))] uint32 __ndr_size_dn;
267 [charset(UTF16),size_is(__ndr_size_dn+1)] uint16 dn[];
268 } drsuapi_DsReplicaObjectIdentifier;
270 typedef struct {
271 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
272 GUID source_dsa_guid;
273 [charset(DOS),string] char *source_dsa_dns; /* Source DSA dns_name in <guid>._msdcs.<domain_dns> form */
274 drsuapi_DrsOptions options;
275 } drsuapi_DsReplicaSyncRequest1;
277 typedef [switch_type(uint32)] union {
278 [case(1)] drsuapi_DsReplicaSyncRequest1 req1;
279 } drsuapi_DsReplicaSyncRequest;
281 WERROR drsuapi_DsReplicaSync(
282 [in] policy_handle *bind_handle,
283 [in] uint32 level,
284 [in,switch_is(level)] drsuapi_DsReplicaSyncRequest *req
287 /*****************/
288 /* Function 0x03 */
289 typedef [public] struct {
290 hyper tmp_highest_usn; /* updated after each object update */
291 hyper reserved_usn;
292 hyper highest_usn; /* updated after a full replication cycle */
293 } drsuapi_DsReplicaHighWaterMark;
295 typedef [public] struct {
296 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
297 hyper highest_usn; /* updated after a full replication cycle */
298 } drsuapi_DsReplicaCursor;
300 typedef struct {
301 [value(1)] uint32 version;
302 [value(0)] uint32 reserved1;
303 [range(0,0x100000)] uint32 count;
304 [value(0)] uint32 reserved2;
305 [size_is(count)] drsuapi_DsReplicaCursor cursors[];
306 } drsuapi_DsReplicaCursorCtrEx;
308 typedef [flag(NDR_PAHEX),v1_enum] enum {
309 DRSUAPI_EXOP_NONE = 0x00000000,
310 DRSUAPI_EXOP_FSMO_REQ_ROLE = 0x00000001,
311 DRSUAPI_EXOP_FSMO_RID_ALLOC = 0x00000002,
312 DRSUAPI_EXOP_FSMO_RID_REQ_ROLE = 0x00000003,
313 DRSUAPI_EXOP_FSMO_REQ_PDC = 0x00000004,
314 DRSUAPI_EXOP_FSMO_ABANDON_ROLE = 0x00000005,
315 DRSUAPI_EXOP_REPL_OBJ = 0x00000006,
316 DRSUAPI_EXOP_REPL_SECRET = 0x00000007
317 } drsuapi_DsExtendedOperation;
319 typedef [flag(NDR_PAHEX),v1_enum] enum {
320 DRSUAPI_EXOP_ERR_NONE = 0x00000000,
321 DRSUAPI_EXOP_ERR_SUCCESS = 0x00000001,
322 DRSUAPI_EXOP_ERR_UNKNOWN_OP = 0x00000002,
323 DRSUAPI_EXOP_ERR_FSMO_NOT_OWNER = 0x00000003,
324 DRSUAPI_EXOP_ERR_UPDATE_ERR = 0x00000004,
325 DRSUAPI_EXOP_ERR_EXCEPTION = 0x00000005,
326 DRSUAPI_EXOP_ERR_UNKNOWN_CALLER = 0x00000006,
327 DRSUAPI_EXOP_ERR_RID_ALLOC = 0x00000007,
328 DRSUAPI_EXOP_ERR_FSMO_OWNER_DELETED = 0x00000008,
329 DRSUAPI_EXOP_ERR_FMSO_PENDING_OP = 0x00000009,
330 DRSUAPI_EXOP_ERR_MISMATCH = 0x0000000A,
331 DRSUAPI_EXOP_ERR_COULDNT_CONTACT = 0x0000000B,
332 DRSUAPI_EXOP_ERR_FSMO_REFUSING_ROLES = 0x0000000C,
333 DRSUAPI_EXOP_ERR_DIR_ERROR = 0x0000000D,
334 DRSUAPI_EXOP_ERR_FSMO_MISSING_SETTINGS = 0x0000000E,
335 DRSUAPI_EXOP_ERR_ACCESS_DENIED = 0x0000000F,
336 DRSUAPI_EXOP_ERR_PARAM_ERROR = 0x00000010
337 } drsuapi_DsExtendedError;
339 typedef struct {
340 GUID destination_dsa_guid;
341 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
342 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
343 drsuapi_DsReplicaHighWaterMark highwatermark;
344 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
345 drsuapi_DrsOptions replica_flags;
346 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
347 uint32 max_ndr_size; /* w2k3 seems to ignore this */
348 drsuapi_DsExtendedOperation extended_op;
349 hyper fsmo_info;
350 } drsuapi_DsGetNCChangesRequest5;
353 * In DRSUAPI all attributes with syntax 2.5.5.2
354 * are identified by uint32 values
356 * the following table shows the mapping used between the two representations
357 * e.g. - objectClass 'nTDSDSA' has governsID: 1.2.840.113556.1.5.7000.47
358 * and a UINT32-ID of '0x0017002F'.
359 * - so the OID 1.2.840.113556.1.5.7000.47 is splitted into a
360 * OID-prefix: 1.2.840.113556.1.5.7000
361 * and a value: 47 => 0x2F
362 * - the mapping table gives a UINT32-prefix: 0x00170000
363 * - and the UINT32-ID is 0x0017002F = 0x00170000 | 0x2F
365 * This prefix mapping table is replied in the drsuapi_DsReplicaOIDMapping_Ctr
366 * array. The following are the default mappings of w2k3
368 * OID-prefix => UINT32-Id prefix
370 * 2.5.4.* => 0x00000000 (standard attributes RFC2256 core.schema)
371 * 2.5.6.* => 0x00010000 (standard object classes RFC2256 core.schema)
372 * 1.2.840.113556.1.2.* => 0x00020000
373 * 1.2.840.113556.1.3.* => 0x00030000
374 * 2.5.5.* => 0x00080000 (attributeSyntax OID's)
375 * 1.2.840.113556.1.4.* => 0x00090000
376 * 1.2.840.113556.1.5.* => 0x000A0000
377 * 2.16.840.1.113730.3.* => 0x00140000
378 * 0.9.2342.19200300.100.1.* => 0x00150000
379 * 2.16.840.1.113730.3.1.* => 0x00160000
380 * 1.2.840.113556.1.5.7000.* => 0x00170000
381 * 2.5.21.* => 0x00180000 (attrs for SubSchema)
382 * 2.5.18.* => 0x00190000 (createTimeStamp,modifyTimeStamp, SubSchema)
383 * 2.5.20.* => 0x001A0000
384 * 1.3.6.1.4.1.1466.101.119.* => 0x001B0000 (dynamicObject, entryTTL)
385 * 2.16.840.1.113730.3.2.* => 0x001C0000
386 * 1.3.6.1.4.1.250.1.* => 0x001D0000
387 * 1.2.840.113549.1.9.* => 0x001E0000 (unstructuredAddress,unstructuredName)
388 * 0.9.2342.19200300.100.4.* => 0x001F0000
390 * Here's a list of used 'attributeSyntax' OID's
392 * 2.5.5.1 => Object(DS-DN) string
393 * struct drsuapi_DsObjectIdentifier3
395 * 2.5.5.2 => OID-string
396 * => all values are represented as uint32 values in drsuapi
397 * => governsID, attributeID and attributeSyntax returned as OID-Strings in LDAP
398 * => mayContain, mustContain and all other attributes with 2.5.5.2 syntax
399 * are returned as attribute names
401 * 2.5.5.4 => String(Teletex) case-insensitive string with teletex charset
403 * 2.5.5.5 => String(IA5) case-sensitive string
405 * 2.5.5.6 => String(Numeric)
406 * => eg. internationalISDNNumber
408 * 2.5.5.7 => Object(DN-Binary) B:<byte count>:<bytes>:<object DN>
409 * => e.g. wellKnownObjects
411 * 2.5.5.8 => BOOL
413 * 2.5.5.9 => int32
415 * 2.5.5.10 => DATA_BLOB
416 * => struct GUID
418 * 2.5.5.11 => LDAP timestring
419 * => NTTIME_1sec
421 * 2.5.5.12 => String(Unicode) case-insensitive string
422 * => 'standard strings'
424 * 2.5.5.13 => Object(Presentation-Address) string
425 * => used in objectClass applicationEntity
427 * 2.5.5.14 => Object(DN-String) S:<char count>:<string>:<object DN>
428 * => not used
430 * 2.5.5.15 => ntSecurityDescriptor
432 * 2.5.5.16 => int64
434 * 2.5.5.17 => dom_sid
436 typedef [noprint] struct {
437 [range(0,10000)] uint32 length;
438 [size_is(length)] uint8 *binary_oid; /* partial-binary-OID encoded with asn1_write_partial_OID_String() */
439 } drsuapi_DsReplicaOID;
441 typedef struct {
442 uint32 id_prefix;
443 drsuapi_DsReplicaOID oid;
444 } drsuapi_DsReplicaOIDMapping;
446 typedef [public] struct {
447 [range(0,0x100000)] uint32 num_mappings;
448 [size_is(num_mappings)] drsuapi_DsReplicaOIDMapping *mappings;
449 } drsuapi_DsReplicaOIDMapping_Ctr;
451 typedef [flag(NDR_PAHEX),v1_enum] enum {
452 DRSUAPI_OBJECTCLASS_top = 0x00010000,
453 DRSUAPI_OBJECTCLASS_classSchema = 0x0003000d,
454 DRSUAPI_OBJECTCLASS_attributeSchema = 0x0003000e
455 } drsuapi_DsObjectClassId;
457 typedef [flag(NDR_PAHEX),v1_enum,public] enum {
458 DRSUAPI_ATTID_objectClass = 0x00000000,
459 DRSUAPI_ATTID_cn = 0x00000003,
460 DRSUAPI_ATTID_ou = 0x0000000b,
461 DRSUAPI_ATTID_description = 0x0000000d,
462 DRSUAPI_ATTID_member = 0x0000001f,
463 DRSUAPI_ATTID_distinguishedName = 0x00000031,
464 DRSUAPI_ATTID_instanceType = 0x00020001,
465 DRSUAPI_ATTID_whenCreated = 0x00020002,
466 DRSUAPI_ATTID_possSuperiors = 0x00020008,
467 DRSUAPI_ATTID_displayName = 0x0002000d,
468 DRSUAPI_ATTID_hasMasterNCs = 0x0002000e,
469 DRSUAPI_ATTID_nCName = 0x00020010,
470 DRSUAPI_ATTID_subClassOf = 0x00020015,
471 DRSUAPI_ATTID_governsID = 0x00020016,
472 DRSUAPI_ATTID_mustContain = 0x00020018,
473 DRSUAPI_ATTID_mayContain = 0x00020019,
474 DRSUAPI_ATTID_rDNAttId = 0x0002001A,
475 DRSUAPI_ATTID_attributeID = 0x0002001e,
476 DRSUAPI_ATTID_attributeSyntax = 0x00020020,
477 DRSUAPI_ATTID_isSingleValued = 0x00020021,
478 DRSUAPI_ATTID_rangeLower = 0x00020022,
479 DRSUAPI_ATTID_rangeUpper = 0x00020023,
480 DRSUAPI_ATTID_dMDLocation = 0x00020024,
481 DRSUAPI_ATTID_isDeleted = 0x00020030,
482 DRSUAPI_ATTID_objectVersion = 0x0002004c,
483 DRSUAPI_ATTID_invocationId = 0x00020073,
484 DRSUAPI_ATTID_showInAdvancedViewOnly = 0x000200a9,
485 DRSUAPI_ATTID_adminDisplayName = 0x000200c2,
486 DRSUAPI_ATTID_adminDescription = 0x000200e2,
487 DRSUAPI_ATTID_oMSyntax = 0x000200e7,
488 DRSUAPI_ATTID_ntSecurityDescriptor = 0x00020119,
489 DRSUAPI_ATTID_searchFlags = 0x0002014e,
490 DRSUAPI_ATTID_auxiliaryClass = 0x0002015f,
491 DRSUAPI_ATTID_lDAPDisplayName = 0x000201cc,
492 DRSUAPI_ATTID_name = 0x00090001,
493 DRSUAPI_ATTID_objectGUID = 0x00090002,
494 DRSUAPI_ATTID_replPropertyMetaData = 0x00090003,
495 DRSUAPI_ATTID_userAccountControl = 0x00090008,
496 DRSUAPI_ATTID_badPwdCount = 0x0009000c,
497 DRSUAPI_ATTID_codePage = 0x00090010,
498 DRSUAPI_ATTID_countryCode = 0x00090019,
499 DRSUAPI_ATTID_currentValue = 0x0009001b,
500 DRSUAPI_ATTID_homeDirectory = 0x0009002c,
501 DRSUAPI_ATTID_homeDrive = 0x0009002d,
502 DRSUAPI_ATTID_lastLogoff = 0x00090033,
503 DRSUAPI_ATTID_lastLogon = 0x00090034,
504 DRSUAPI_ATTID_dBCSPwd = 0x00090037,/* lmPwdHash */
505 DRSUAPI_ATTID_scriptPath = 0x0009003e,
506 DRSUAPI_ATTID_logonHours = 0x00090040,
507 DRSUAPI_ATTID_userWorkstations = 0x00090056,
508 DRSUAPI_ATTID_unicodePwd = 0x0009005a,/* ntPwdHash */
509 DRSUAPI_ATTID_ntPwdHistory = 0x0009005e,
510 DRSUAPI_ATTID_pwdLastSet = 0x00090060,
511 DRSUAPI_ATTID_primaryGroupID = 0x00090062,
512 DRSUAPI_ATTID_priorValue = 0x00090064,
513 DRSUAPI_ATTID_supplementalCredentials = 0x0009007d,
514 DRSUAPI_ATTID_trustAuthIncoming = 0x00090081,
515 DRSUAPI_ATTID_trustAuthOutgoing = 0x00090087,
516 DRSUAPI_ATTID_userParameters = 0x0009008a,
517 DRSUAPI_ATTID_profilePath = 0x0009008b,
518 DRSUAPI_ATTID_operatorCount = 0x00090090,
519 DRSUAPI_ATTID_objectSid = 0x00090092,
520 DRSUAPI_ATTID_schemaIDGUID = 0x00090094,
521 DRSUAPI_ATTID_adminCount = 0x00090096,
522 DRSUAPI_ATTID_comment = 0x0009009C,/* User-Comment */
523 DRSUAPI_ATTID_accountExpires = 0x0009009f,
524 DRSUAPI_ATTID_lmPwdHistory = 0x000900a0,
525 DRSUAPI_ATTID_logonCount = 0x000900a9,
526 DRSUAPI_ATTID_systemPossSuperiors = 0x000900c3,
527 DRSUAPI_ATTID_systemMayContain = 0x000900c4,
528 DRSUAPI_ATTID_systemMustContain = 0x000900c5,
529 DRSUAPI_ATTID_systemAuxiliaryClass = 0x000900c6,
530 DRSUAPI_ATTID_sAMAccountName = 0x000900dd,
531 DRSUAPI_ATTID_sAMAccountType = 0x0009012e,
532 DRSUAPI_ATTID_options = 0x00090133,
533 DRSUAPI_ATTID_fSMORoleOwner = 0x00090171,
534 DRSUAPI_ATTID_systemFlags = 0x00090177,
535 DRSUAPI_ATTID_serverReference = 0x00090203,
536 DRSUAPI_ATTID_serverReferenceBL = 0x00090204,
537 DRSUAPI_ATTID_nonSecurityMember = 0x00090212,
538 DRSUAPI_ATTID_initialAuthIncoming = 0x0009021b,
539 DRSUAPI_ATTID_initialAuthOutgoing = 0x0009021c,
540 DRSUAPI_ATTID_wellKnownObjects = 0x0009026a,
541 DRSUAPI_ATTID_dNSHostName = 0x0009026b,
542 DRSUAPI_ATTID_isMemberOfPartialAttributeSet = 0x0009027f,
543 DRSUAPI_ATTID_managedBy = 0x0009028d,
544 DRSUAPI_ATTID_userPrincipalName = 0x00090290,
545 DRSUAPI_ATTID_groupType = 0x000902ee,
546 DRSUAPI_ATTID_servicePrincipalName = 0x00090303,
547 DRSUAPI_ATTID_lastKnownParent = 0x0009030d,
548 DRSUAPI_ATTID_objectCategory = 0x0009030e,
549 DRSUAPI_ATTID_gPLink = 0x0009037b,
550 DRSUAPI_ATTID_transportAddressAttribute = 0x0009037f,
551 DRSUAPI_ATTID_msDS_Behavior_Version = 0x000905b3,
552 DRSUAPI_ATTID_msDS_KeyVersionNumber = 0x000906f6,
553 DRSUAPI_ATTID_msDS_NonMembers = 0x00090701,
554 DRSUAPI_ATTID_msDS_MembersForAzRole = 0x0009070e,
555 DRSUAPI_ATTID_msDS_HasDomainNCs = 0x0009071c,
556 DRSUAPI_ATTID_msDS_hasMasterNCs = 0x0009072c,
557 DRSUAPI_ATTID_msDS_NeverRevealGroup = 0x00090786,
558 DRSUAPI_ATTID_msDS_RevealOnDemandGroup = 0x00090788,
559 DRSUAPI_ATTID_msDS_HostServiceAccount = 0x00090808,
560 DRSUAPI_ATTID_isRecycled = 0x0009080a,
562 DRSUAPI_ATTID_INVALID = 0xFFFFFFFF
563 } drsuapi_DsAttributeId;
565 typedef struct {
566 [value(1)] uint32 version;
567 [value(0)] uint32 reserved1;
568 [range(1,0x100000)] uint32 num_attids;
569 [size_is(num_attids)] drsuapi_DsAttributeId attids[];
570 } drsuapi_DsPartialAttributeSet;
572 typedef [public] struct {
573 GUID destination_dsa_guid;
574 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
575 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
576 drsuapi_DsReplicaHighWaterMark highwatermark;
577 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
578 drsuapi_DrsOptions replica_flags;
579 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
580 uint32 max_ndr_size; /* w2k3 seems to ignore this */
581 drsuapi_DsExtendedOperation extended_op;
582 hyper fsmo_info;
583 drsuapi_DsPartialAttributeSet *partial_attribute_set;
584 drsuapi_DsPartialAttributeSet *partial_attribute_set_ex;
585 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
586 } drsuapi_DsGetNCChangesRequest8;
588 typedef [public] struct {
589 GUID destination_dsa_guid;
590 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
591 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
592 drsuapi_DsReplicaHighWaterMark highwatermark;
593 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
594 drsuapi_DrsOptions replica_flags;
595 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
596 uint32 max_ndr_size; /* w2k3 seems to ignore this */
597 drsuapi_DsExtendedOperation extended_op;
598 hyper fsmo_info;
599 drsuapi_DsPartialAttributeSet *partial_attribute_set;
600 drsuapi_DsPartialAttributeSet *partial_attribute_set_ex;
601 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
602 drsuapi_DrsMoreOptions more_flags;
603 } drsuapi_DsGetNCChangesRequest10;
605 typedef [switch_type(uint32)] union {
606 [case(5)] drsuapi_DsGetNCChangesRequest5 req5;
607 [case(8)] drsuapi_DsGetNCChangesRequest8 req8;
608 [case(10)] drsuapi_DsGetNCChangesRequest10 req10;
609 } drsuapi_DsGetNCChangesRequest;
611 typedef [public] struct {
612 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
613 hyper highest_usn; /* updated after a full replication cycle */
614 NTTIME last_sync_success;
615 } drsuapi_DsReplicaCursor2;
617 typedef struct {
618 [value(2)] uint32 version;
619 [value(0)] uint32 reserved1;
620 [range(0,0x100000)] uint32 count;
621 [value(0)] uint32 reserved2;
622 [size_is(count)] drsuapi_DsReplicaCursor2 cursors[];
623 } drsuapi_DsReplicaCursor2CtrEx;
625 /* Generic DATA_BLOB values */
626 typedef struct {
627 [range(0,26214400),value(ndr_size_DATA_BLOB(0,blob,0))] uint32 __ndr_size;
628 DATA_BLOB *blob;
629 } drsuapi_DsAttributeValue;
631 typedef struct {
632 [range(0,10485760)] uint32 num_values;
633 [size_is(num_values)] drsuapi_DsAttributeValue *values;
634 } drsuapi_DsAttributeValueCtr;
636 /* DN String values */
637 typedef [public,gensize] struct {
638 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier3(r, ndr->flags))] uint32 __ndr_size;
639 [value(ndr_size_dom_sid28(&sid,ndr->flags))] uint32 __ndr_size_sid;
640 GUID guid;
641 dom_sid28 sid;
642 [value(strlen_m(dn))] uint32 __ndr_size_dn;
643 [charset(UTF16)] uint16 dn[__ndr_size_dn+1];
644 } drsuapi_DsReplicaObjectIdentifier3;
646 typedef [public] struct {
647 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier3Binary_without_Binary(r, ndr->flags))] uint32 __ndr_size;
648 [value(ndr_size_dom_sid28(&sid,ndr->flags))] uint32 __ndr_size_sid;
649 GUID guid;
650 dom_sid28 sid;
651 [value(strlen_m(dn))] uint32 __ndr_size_dn;
652 [charset(UTF16)] uint16 dn[__ndr_size_dn+1];
653 [value(binary.length + 4)] uint32 __ndr_size_binary;
654 [flag(NDR_REMAINING)] DATA_BLOB binary;
655 } drsuapi_DsReplicaObjectIdentifier3Binary;
657 typedef [public,noprint] struct {
658 drsuapi_DsAttributeId attid;
659 drsuapi_DsAttributeValueCtr value_ctr;
660 } drsuapi_DsReplicaAttribute;
662 typedef struct {
663 [range(0,1048576)] uint32 num_attributes;
664 [size_is(num_attributes)] drsuapi_DsReplicaAttribute *attributes;
665 } drsuapi_DsReplicaAttributeCtr;
667 typedef [public] bitmap {
668 DRSUAPI_DS_REPLICA_OBJECT_FROM_MASTER = 0x00000001,
669 DRSUAPI_DS_REPLICA_OBJECT_DYNAMIC = 0x00000002,
670 DRSUAPI_DS_REPLICA_OBJECT_REMOTE_MODIFY = 0x00010000
671 } drsuapi_DsReplicaObjectFlags;
673 typedef [public] struct {
674 drsuapi_DsReplicaObjectIdentifier *identifier;
675 drsuapi_DsReplicaObjectFlags flags;
676 drsuapi_DsReplicaAttributeCtr attribute_ctr;
677 } drsuapi_DsReplicaObject;
679 typedef struct {
680 uint32 version;
681 NTTIME_1sec originating_change_time;
682 GUID originating_invocation_id;
683 hyper originating_usn;
684 } drsuapi_DsReplicaMetaData;
686 typedef [public] struct {
687 [range(0,1048576)] uint32 count;
688 [size_is(count)] drsuapi_DsReplicaMetaData meta_data[];
689 } drsuapi_DsReplicaMetaDataCtr;
691 typedef [public,noprint] struct {
692 drsuapi_DsReplicaObjectListItemEx *next_object;
693 drsuapi_DsReplicaObject object;
694 boolean32 is_nc_prefix;
695 GUID *parent_object_guid;
696 drsuapi_DsReplicaMetaDataCtr *meta_data_ctr;
697 } drsuapi_DsReplicaObjectListItemEx;
699 typedef [public,gensize] struct {
700 GUID source_dsa_guid; /* the 'objectGUID' field of the CN=NTDS Settings object */
701 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
702 drsuapi_DsReplicaObjectIdentifier *naming_context;
703 drsuapi_DsReplicaHighWaterMark old_highwatermark;
704 drsuapi_DsReplicaHighWaterMark new_highwatermark;
705 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
706 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
707 drsuapi_DsExtendedError extended_ret; /* w2k sends the nc_object_count value here */
708 uint32 object_count;
709 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
710 [value(ndr_size_drsuapi_DsGetNCChangesCtr1(r,ndr->flags)+55)] uint32 __ndr_size;
711 drsuapi_DsReplicaObjectListItemEx *first_object;
712 boolean32 more_data;
713 } drsuapi_DsGetNCChangesCtr1;
716 * if the DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE flag
717 * isn't there it means the value is deleted
719 typedef [public] bitmap {
720 DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE = 0x00000001
721 } drsuapi_DsLinkedAttributeFlags;
723 typedef [public] struct {
724 drsuapi_DsReplicaObjectIdentifier *identifier;
725 drsuapi_DsAttributeId attid;
726 drsuapi_DsAttributeValue value;
727 drsuapi_DsLinkedAttributeFlags flags;
728 NTTIME_1sec originating_add_time;
729 drsuapi_DsReplicaMetaData meta_data;
730 } drsuapi_DsReplicaLinkedAttribute;
732 /* [MS-DRSR] section 4.1.10.2.11 DRS_MSG_GETCHGREPLY_V6 */
733 typedef [public,gensize] struct {
734 GUID source_dsa_guid; /* the 'objectGUID' field of the CN=NTDS Settings object */
735 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
736 drsuapi_DsReplicaObjectIdentifier *naming_context;
737 drsuapi_DsReplicaHighWaterMark old_highwatermark;
738 drsuapi_DsReplicaHighWaterMark new_highwatermark;
739 drsuapi_DsReplicaCursor2CtrEx *uptodateness_vector;
740 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
741 drsuapi_DsExtendedError extended_ret;
742 uint32 object_count;
743 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
744 [value(ndr_size_drsuapi_DsGetNCChangesCtr6(r,ndr->flags)+55)] uint32 __ndr_size;
745 drsuapi_DsReplicaObjectListItemEx *first_object;
746 boolean32 more_data;
747 uint32 nc_object_count; /* estimated amount of objects in the whole NC */
748 uint32 nc_linked_attributes_count; /* estimated amount of linked values in the whole NC */
749 [range(0,1048576)] uint32 linked_attributes_count;
750 [size_is(linked_attributes_count)] drsuapi_DsReplicaLinkedAttribute *linked_attributes;
751 WERROR drs_error;
752 } drsuapi_DsGetNCChangesCtr6;
754 typedef [public] struct {
755 [subcontext(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr1 ctr1;
756 } drsuapi_DsGetNCChangesCtr1TS;
758 typedef [public] struct {
759 [subcontext(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr6 ctr6;
760 } drsuapi_DsGetNCChangesCtr6TS;
762 typedef [nopush] struct {
763 uint32 decompressed_length;
764 uint32 compressed_length;
765 [subcontext(4),subcontext_size(compressed_length),
766 compression(NDR_COMPRESSION_MSZIP,compressed_length,decompressed_length)]
767 drsuapi_DsGetNCChangesCtr1TS *ts;
768 } drsuapi_DsGetNCChangesMSZIPCtr1;
770 typedef [nopush] struct {
771 uint32 decompressed_length;
772 uint32 compressed_length;
773 [subcontext(4),subcontext_size(compressed_length),
774 compression(NDR_COMPRESSION_MSZIP,compressed_length,decompressed_length)]
775 drsuapi_DsGetNCChangesCtr6TS *ts;
776 } drsuapi_DsGetNCChangesMSZIPCtr6;
778 typedef [nopush] struct {
779 uint32 decompressed_length;
780 uint32 compressed_length;
781 [subcontext(4),subcontext_size(compressed_length),
782 compression(NDR_COMPRESSION_XPRESS,compressed_length,decompressed_length)]
783 drsuapi_DsGetNCChangesCtr1TS *ts;
784 } drsuapi_DsGetNCChangesXPRESSCtr1;
786 typedef [nopush] struct {
787 uint32 decompressed_length;
788 uint32 compressed_length;
789 [subcontext(4),subcontext_size(compressed_length),
790 compression(NDR_COMPRESSION_XPRESS,compressed_length,decompressed_length)]
791 drsuapi_DsGetNCChangesCtr6TS *ts;
792 } drsuapi_DsGetNCChangesXPRESSCtr6;
794 typedef [enum16bit] enum {
795 DRSUAPI_COMPRESSION_TYPE_MSZIP = 2,
796 DRSUAPI_COMPRESSION_TYPE_XPRESS = 3
797 } drsuapi_DsGetNCChangesCompressionType;
799 typedef [nodiscriminant,flag(NDR_PAHEX)] union {
800 [case(1|(DRSUAPI_COMPRESSION_TYPE_MSZIP<<16))] drsuapi_DsGetNCChangesMSZIPCtr1 mszip1;
801 [case(6|(DRSUAPI_COMPRESSION_TYPE_MSZIP<<16))] drsuapi_DsGetNCChangesMSZIPCtr6 mszip6;
802 [case(1|(DRSUAPI_COMPRESSION_TYPE_XPRESS<<16))] drsuapi_DsGetNCChangesXPRESSCtr1 xpress1;
803 [case(6|(DRSUAPI_COMPRESSION_TYPE_XPRESS<<16))] drsuapi_DsGetNCChangesXPRESSCtr6 xpress6;
804 } drsuapi_DsGetNCChangesCompressedCtr;
806 typedef struct {
807 drsuapi_DsGetNCChangesMSZIPCtr1 mszip1;
808 } drsuapi_DsGetNCChangesCtr2;
810 typedef struct {
811 [range(0,6)] uint32 level;
812 [range(2,3)] drsuapi_DsGetNCChangesCompressionType type;
813 [switch_is(level | (type<<16))] drsuapi_DsGetNCChangesCompressedCtr ctr;
814 } drsuapi_DsGetNCChangesCtr7;
816 typedef [switch_type(uint32)] union {
817 [case(1)] drsuapi_DsGetNCChangesCtr1 ctr1;
818 [case(2)] drsuapi_DsGetNCChangesCtr2 ctr2;
819 [case(6)] drsuapi_DsGetNCChangesCtr6 ctr6;
820 [case(7)] drsuapi_DsGetNCChangesCtr7 ctr7;
821 } drsuapi_DsGetNCChangesCtr;
823 WERROR drsuapi_DsGetNCChanges(
824 [in] policy_handle *bind_handle,
825 [in] uint32 level,
826 [in,ref,switch_is(level)] drsuapi_DsGetNCChangesRequest *req,
827 [out,ref] uint32 *level_out,
828 [out,ref,switch_is(*level_out)] drsuapi_DsGetNCChangesCtr *ctr
831 /*****************/
832 /* Function 0x04 */
833 /* [MS-DRSR] 4.1.26 */
835 typedef struct {
836 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
837 [ref,charset(DOS),string] uint8 *dest_dsa_dns_name;
838 GUID dest_dsa_guid;
839 drsuapi_DrsOptions options;
840 } drsuapi_DsReplicaUpdateRefsRequest1;
842 typedef [switch_type(uint32)] union {
843 [case(1)] drsuapi_DsReplicaUpdateRefsRequest1 req1;
844 } drsuapi_DsReplicaUpdateRefsRequest;
846 WERROR drsuapi_DsReplicaUpdateRefs(
847 [in] policy_handle *bind_handle,
848 [in] uint32 level,
849 [in,switch_is(level)] drsuapi_DsReplicaUpdateRefsRequest req
852 /*****************/
853 /* Function 0x05 */
855 typedef struct {
856 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
857 [charset(UTF16),string] uint16 *source_dsa_address;
858 uint8 schedule[84];
859 drsuapi_DrsOptions options;
860 } drsuapi_DsReplicaAddRequest1;
862 typedef struct {
863 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
864 drsuapi_DsReplicaObjectIdentifier *source_dsa_dn;
865 drsuapi_DsReplicaObjectIdentifier *transport_dn;
866 [charset(UTF16),string] uint16 *source_dsa_address;
867 uint8 schedule[84];
868 drsuapi_DrsOptions options;
869 } drsuapi_DsReplicaAddRequest2;
871 typedef [switch_type(uint32)] union {
872 [case(1)] drsuapi_DsReplicaAddRequest1 req1;
873 [case(2)] drsuapi_DsReplicaAddRequest2 req2;
874 } drsuapi_DsReplicaAddRequest;
876 WERROR drsuapi_DsReplicaAdd(
877 [in] policy_handle *bind_handle,
878 [in] uint32 level,
879 [in,switch_is(level)] drsuapi_DsReplicaAddRequest req
883 /*****************/
884 /* Function 0x06 */
885 typedef struct {
886 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
887 [charset(UTF8), string] uint8 *source_dsa_address;
888 drsuapi_DrsOptions options;
889 } drsuapi_DsReplicaDelRequest1;
891 typedef [switch_type(uint32)] union {
892 [case(1)] drsuapi_DsReplicaDelRequest1 req1;
893 } drsuapi_DsReplicaDelRequest;
895 WERROR drsuapi_DsReplicaDel(
896 [in] policy_handle *bind_handle,
897 [in] uint32 level,
898 [in,switch_is(level)] drsuapi_DsReplicaDelRequest req
901 /*****************/
902 /* Function 0x07 */
904 typedef struct {
905 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
906 GUID source_dra;
907 [charset(UTF16),string] uint16 *source_dra_address;
908 uint8 schedule[84];
909 drsuapi_DrsOptions replica_flags;
910 uint32 modify_fields;
911 drsuapi_DrsOptions options;
912 } drsuapi_DsReplicaModRequest1;
914 typedef [switch_type(uint32)] union {
915 [case(1)] drsuapi_DsReplicaModRequest1 req1;
916 } drsuapi_DsReplicaModRequest;
918 WERROR drsuapi_DsReplicaMod(
919 [in] policy_handle *bind_handle,
920 [in] uint32 level,
921 [in,switch_is(level)] drsuapi_DsReplicaModRequest req
924 /*****************/
925 /* Function 0x08 */
926 [todo] WERROR DRSUAPI_VERIFY_NAMES();
928 /*****************/
929 /* Function 0x09 */
931 /* how are type 4 and 7 different from 2 and 3 ? */
932 typedef [v1_enum] enum {
933 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_AND_DOMAIN_GROUPS = 1,
934 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS = 2,
935 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS = 3,
936 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS2 = 4,
937 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_GROUPS = 5,
938 DRSUAPI_DS_MEMBERSHIP_TYPE_GROUPMEMBERS = 6,
939 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS2 = 7
940 } drsuapi_DsMembershipType;
942 typedef struct {
943 NTSTATUS status;
944 [range(0,10000)] uint32 num_memberships;
945 [range(0,10000)] uint32 num_sids;
946 [size_is(num_memberships)] drsuapi_DsReplicaObjectIdentifier **info_array;
947 [size_is(num_memberships)] samr_GroupAttrs *group_attrs;
948 [size_is(num_sids)] dom_sid28 **sids;
949 } drsuapi_DsGetMembershipsCtr1;
951 typedef [switch_type(uint32)] union {
952 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1;
953 } drsuapi_DsGetMembershipsCtr;
955 const int DRSUAPI_DS_MEMBERSHIP_FLAG_GROUP_ATTR = 0x1;
957 typedef struct {
958 [range(1,10000)] uint32 count;
959 [size_is(count)] drsuapi_DsReplicaObjectIdentifier **info_array;
960 uint32 flags;
961 [range(1,7)] drsuapi_DsMembershipType type;
962 drsuapi_DsReplicaObjectIdentifier *domain;
963 } drsuapi_DsGetMembershipsRequest1;
965 typedef [switch_type(uint32)] union {
966 [case(1)] drsuapi_DsGetMembershipsRequest1 req1;
967 } drsuapi_DsGetMembershipsRequest;
969 WERROR drsuapi_DsGetMemberships(
970 [in] policy_handle *bind_handle,
971 [in] uint32 level,
972 [in,ref] [switch_is(level)] drsuapi_DsGetMembershipsRequest *req,
973 [out,ref] uint32 *level_out,
974 [out,ref] [switch_is(*level_out)] drsuapi_DsGetMembershipsCtr *ctr
977 /*****************/
978 /* Function 0x0a */
979 [todo] WERROR DRSUAPI_INTER_DOMAIN_MOVE();
981 /*****************/
982 /* Function 0x0b */
983 typedef [bitmap32bit] bitmap {
984 DRSUAPI_NT4_CHANGELOG_GET_CHANGELOG = 0x00000001,
985 DRSUAPI_NT4_CHANGELOG_GET_SERIAL_NUMBERS = 0x00000002
986 } drsuapi_DsGetNT4ChangeLogFlags;
988 typedef struct {
989 drsuapi_DsGetNT4ChangeLogFlags flags;
990 uint32 preferred_maximum_length;
991 [range(0,0x00A00000)] uint32 restart_length;
992 [size_is(restart_length)] uint8 *restart_data;
993 } drsuapi_DsGetNT4ChangeLogRequest1;
995 typedef [switch_type(uint32)] union {
996 [case(1)] drsuapi_DsGetNT4ChangeLogRequest1 req1;
997 } drsuapi_DsGetNT4ChangeLogRequest;
999 typedef struct {
1000 [range(0,0x00A00000)] uint32 restart_length;
1001 [range(0,0x00A00000)] uint32 log_length;
1002 hyper sam_serial_number;
1003 NTTIME sam_creation_time;
1004 hyper builtin_serial_number;
1005 NTTIME builtin_creation_time;
1006 hyper lsa_serial_number;
1007 NTTIME lsa_creation_time;
1008 NTSTATUS status;
1009 [size_is(restart_length)] uint8 *restart_data;
1010 [size_is(log_length)] uint8 *log_data;
1011 } drsuapi_DsGetNT4ChangeLogInfo1;
1013 typedef [switch_type(uint32)] union {
1014 [case(1)] drsuapi_DsGetNT4ChangeLogInfo1 info1;
1015 } drsuapi_DsGetNT4ChangeLogInfo;
1017 WERROR drsuapi_DsGetNT4ChangeLog(
1018 [in] policy_handle *bind_handle,
1019 [in] uint32 level,
1020 [in,ref] [switch_is(level)] drsuapi_DsGetNT4ChangeLogRequest *req,
1021 [out,ref] uint32 *level_out,
1022 [out,ref] [switch_is(*level_out)] drsuapi_DsGetNT4ChangeLogInfo *info
1025 /*****************/
1026 /* Function 0x0c */
1027 typedef [v1_enum] enum {
1028 DRSUAPI_DS_NAME_STATUS_OK = 0,
1029 DRSUAPI_DS_NAME_STATUS_RESOLVE_ERROR = 1,
1030 DRSUAPI_DS_NAME_STATUS_NOT_FOUND = 2,
1031 DRSUAPI_DS_NAME_STATUS_NOT_UNIQUE = 3,
1032 DRSUAPI_DS_NAME_STATUS_NO_MAPPING = 4,
1033 DRSUAPI_DS_NAME_STATUS_DOMAIN_ONLY = 5,
1034 DRSUAPI_DS_NAME_STATUS_NO_SYNTACTICAL_MAPPING = 6,
1035 DRSUAPI_DS_NAME_STATUS_TRUST_REFERRAL = 7
1036 } drsuapi_DsNameStatus;
1038 typedef [v1_enum] enum {
1039 DRSUAPI_DS_NAME_FLAG_NO_FLAGS = 0x0,
1040 DRSUAPI_DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1,
1041 DRSUAPI_DS_NAME_FLAG_EVAL_AT_DC = 0x2,
1042 DRSUAPI_DS_NAME_FLAG_GCVERIFY = 0x4,
1043 DRSUAPI_DS_NAME_FLAG_TRUST_REFERRAL = 0x8
1044 } drsuapi_DsNameFlags;
1046 typedef [v1_enum] enum {
1047 DRSUAPI_DS_NAME_FORMAT_UNKNOWN = 0x00000000,
1048 DRSUAPI_DS_NAME_FORMAT_FQDN_1779 = 0x00000001,
1049 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT = 0x00000002,
1050 DRSUAPI_DS_NAME_FORMAT_DISPLAY = 0x00000003,
1051 DRSUAPI_DS_NAME_FORMAT_GUID = 0x00000006,
1052 DRSUAPI_DS_NAME_FORMAT_CANONICAL = 0x00000007,
1053 DRSUAPI_DS_NAME_FORMAT_USER_PRINCIPAL = 0x00000008,
1054 DRSUAPI_DS_NAME_FORMAT_CANONICAL_EX = 0x00000009,
1055 DRSUAPI_DS_NAME_FORMAT_SERVICE_PRINCIPAL = 0x0000000A,
1056 DRSUAPI_DS_NAME_FORMAT_SID_OR_SID_HISTORY = 0x0000000B,
1057 DRSUAPI_DS_NAME_FORMAT_DNS_DOMAIN = 0x0000000C,
1058 DRSUAPI_DS_NAME_FORMAT_UPN_AND_ALTSECID = 0xFFFFFFEF,
1059 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN_EX = 0xFFFFFFF0,
1060 DRSUAPI_DS_NAME_FORMAT_LIST_GLOBAL_CATALOG_SERVERS = 0xFFFFFFF1,
1061 DRSUAPI_DS_NAME_FORMAT_UPN_FOR_LOGON = 0xFFFFFFF2,
1062 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_WITH_DCS_IN_SITE = 0xFFFFFFF3,
1063 DRSUAPI_DS_NAME_FORMAT_STRING_SID_NAME = 0xFFFFFFF4,
1064 DRSUAPI_DS_NAME_FORMAT_ALT_SECURITY_IDENTITIES_NAME = 0xFFFFFFF5,
1065 DRSUAPI_DS_NAME_FORMAT_LIST_NCS = 0xFFFFFFF6,
1066 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS = 0xFFFFFFF7,
1067 DRSUAPI_DS_NAME_FORMAT_MAP_SCHEMA_GUID = 0xFFFFFFF8,
1068 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN = 0xFFFFFFF9,
1069 DRSUAPI_DS_NAME_FORMAT_LIST_ROLES = 0xFFFFFFFA,
1070 DRSUAPI_DS_NAME_FORMAT_LIST_INFO_FOR_SERVER = 0xFFFFFFFB,
1071 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_FOR_DOMAIN_IN_SITE = 0xFFFFFFFC,
1072 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS_IN_SITE = 0xFFFFFFFD,
1073 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_IN_SITE = 0xFFFFFFFE,
1074 DRSUAPI_DS_NAME_FORMAT_LIST_SITES = 0xFFFFFFFF
1075 } drsuapi_DsNameFormat;
1077 typedef struct {
1078 [string,charset(UTF16)] uint16 *str;
1079 } drsuapi_DsNameString;
1081 typedef struct {
1082 uint32 codepage; /* 0x000004e4 - 1252 is german codepage*/
1083 uint32 language; /* 0x00000407 - german language ID*/
1084 drsuapi_DsNameFlags format_flags;
1085 drsuapi_DsNameFormat format_offered;
1086 drsuapi_DsNameFormat format_desired;
1087 [range(1,10000)] uint32 count;
1088 [size_is(count)] drsuapi_DsNameString *names;
1089 } drsuapi_DsNameRequest1;
1091 typedef [switch_type(uint32)] union {
1092 [case(1)] drsuapi_DsNameRequest1 req1;
1093 } drsuapi_DsNameRequest;
1095 typedef struct {
1096 drsuapi_DsNameStatus status;
1097 [charset(UTF16),string] uint16 *dns_domain_name;
1098 [charset(UTF16),string] uint16 *result_name;
1099 } drsuapi_DsNameInfo1;
1101 typedef struct {
1102 uint32 count;
1103 [size_is(count)] drsuapi_DsNameInfo1 *array;
1104 } drsuapi_DsNameCtr1;
1106 typedef [switch_type(uint32)] union {
1107 [case(1)] drsuapi_DsNameCtr1 *ctr1;
1108 } drsuapi_DsNameCtr;
1110 WERROR drsuapi_DsCrackNames(
1111 [in] policy_handle *bind_handle,
1112 [in] uint32 level,
1113 [in,ref,switch_is(level)] drsuapi_DsNameRequest *req,
1114 [out,ref] uint32 *level_out,
1115 [out,ref,switch_is(*level_out)] drsuapi_DsNameCtr *ctr
1118 /*****************/
1119 /* Function 0x0d */
1120 typedef [v1_enum] enum {
1121 DRSUAPI_DS_SPN_OPERATION_ADD = 0,
1122 DRSUAPI_DS_SPN_OPERATION_REPLACE= 1,
1123 DRSUAPI_DS_SPN_OPERATION_DELETE = 2
1124 } drsuapi_DsSpnOperation;
1126 typedef struct {
1127 drsuapi_DsSpnOperation operation;
1128 uint32 unknown1;
1129 [charset(UTF16),string] uint16 *object_dn;
1130 [range(0,10000)] uint32 count;
1131 [size_is(count)] drsuapi_DsNameString *spn_names;
1132 } drsuapi_DsWriteAccountSpnRequest1;
1134 typedef [switch_type(uint32)] union {
1135 [case(1)] drsuapi_DsWriteAccountSpnRequest1 req1;
1136 } drsuapi_DsWriteAccountSpnRequest;
1138 typedef struct {
1139 WERROR status;
1140 } drsuapi_DsWriteAccountSpnResult1;
1142 typedef [switch_type(uint32)] union {
1143 [case(1)] drsuapi_DsWriteAccountSpnResult1 res1;
1144 } drsuapi_DsWriteAccountSpnResult;
1146 WERROR drsuapi_DsWriteAccountSpn(
1147 [in] policy_handle *bind_handle,
1148 [in] uint32 level,
1149 [in,ref,switch_is(level)] drsuapi_DsWriteAccountSpnRequest *req,
1150 [out,ref] uint32 *level_out,
1151 [out,ref,switch_is(*level_out)] drsuapi_DsWriteAccountSpnResult *res
1154 /*****************/
1155 /* Function 0x0e */
1156 typedef struct {
1157 [charset(UTF16),string] uint16 *server_dn;
1158 [charset(UTF16),string] uint16 *domain_dn;
1159 boolean32 commit;
1160 } drsuapi_DsRemoveDSServerRequest1;
1162 typedef [switch_type(uint32)] union {
1163 [case(1)] drsuapi_DsRemoveDSServerRequest1 req1;
1164 } drsuapi_DsRemoveDSServerRequest;
1166 typedef struct {
1167 boolean32 last_dc_in_domain;
1168 } drsuapi_DsRemoveDSServerResult1;
1170 typedef [switch_type(uint32)] union {
1171 [case(1)] drsuapi_DsRemoveDSServerResult1 res1;
1172 } drsuapi_DsRemoveDSServerResult;
1174 WERROR drsuapi_DsRemoveDSServer(
1175 [in] policy_handle *bind_handle,
1176 [in] uint32 level,
1177 [in,ref,switch_is(level)] drsuapi_DsRemoveDSServerRequest *req,
1178 [out,ref] uint32 *level_out,
1179 [out,ref,switch_is(*level_out)] drsuapi_DsRemoveDSServerResult *res
1182 /*****************/
1183 /* Function 0x0f */
1184 [todo] WERROR DRSUAPI_REMOVE_DS_DOMAIN();
1186 /*****************/
1187 /* Function 0x10 */
1188 typedef [v1_enum] enum {
1189 DRSUAPI_DC_INFO_CTR_1 = 1,
1190 DRSUAPI_DC_INFO_CTR_2 = 2,
1191 DRSUAPI_DC_INFO_CTR_3 = 3,
1192 DRSUAPI_DC_CONNECTION_CTR_01 = 0xFFFFFFFF
1193 } drsuapi_DsGetDCInfoCtrLevels;
1195 typedef struct {
1196 [charset(UTF16),string] uint16 *domain_name; /* netbios or dns */
1197 drsuapi_DsGetDCInfoCtrLevels level; /* specifies the switch level for the request */
1198 } drsuapi_DsGetDCInfoRequest1;
1200 typedef [switch_type(uint32)] union {
1201 [case(1)] drsuapi_DsGetDCInfoRequest1 req1;
1202 } drsuapi_DsGetDCInfoRequest;
1204 typedef struct {
1205 [charset(UTF16),string] uint16 *netbios_name;
1206 [charset(UTF16),string] uint16 *dns_name;
1207 [charset(UTF16),string] uint16 *site_name;
1208 [charset(UTF16),string] uint16 *computer_dn;
1209 [charset(UTF16),string] uint16 *server_dn;
1210 uint32 is_pdc;
1211 uint32 is_enabled;
1212 } drsuapi_DsGetDCInfo1;
1214 typedef struct {
1215 [range(0,10000)] uint32 count;
1216 [size_is(count)] drsuapi_DsGetDCInfo1 *array;
1217 } drsuapi_DsGetDCInfoCtr1;
1219 typedef struct {
1220 [charset(UTF16),string] uint16 *netbios_name;
1221 [charset(UTF16),string] uint16 *dns_name;
1222 [charset(UTF16),string] uint16 *site_name;
1223 [charset(UTF16),string] uint16 *site_dn;
1224 [charset(UTF16),string] uint16 *computer_dn;
1225 [charset(UTF16),string] uint16 *server_dn;
1226 [charset(UTF16),string] uint16 *ntds_dn;
1227 uint32 is_pdc;
1228 uint32 is_enabled;
1229 uint32 is_gc;
1230 GUID site_guid;
1231 GUID computer_guid;
1232 GUID server_guid;
1233 GUID ntds_guid;
1234 } drsuapi_DsGetDCInfo2;
1236 typedef struct {
1237 [range(0,10000)] uint32 count;
1238 [size_is(count)] drsuapi_DsGetDCInfo2 *array;
1239 } drsuapi_DsGetDCInfoCtr2;
1241 typedef struct {
1242 [charset(UTF16),string] uint16 *netbios_name;
1243 [charset(UTF16),string] uint16 *dns_name;
1244 [charset(UTF16),string] uint16 *site_name;
1245 [charset(UTF16),string] uint16 *site_dn;
1246 [charset(UTF16),string] uint16 *computer_dn;
1247 [charset(UTF16),string] uint16 *server_dn;
1248 [charset(UTF16),string] uint16 *ntds_dn;
1249 uint32 is_pdc;
1250 uint32 is_enabled;
1251 uint32 is_gc;
1252 uint32 is_rodc;
1253 GUID site_guid;
1254 GUID computer_guid;
1255 GUID server_guid;
1256 GUID ntds_guid;
1257 } drsuapi_DsGetDCInfo3;
1259 typedef struct {
1260 [range(0,10000)] uint32 count;
1261 [size_is(count)] drsuapi_DsGetDCInfo3 *array;
1262 } drsuapi_DsGetDCInfoCtr3;
1265 * this represents an active connection to the
1266 * Directory System Agent (DSA)
1267 * this can be via LDAP or DRSUAPI
1269 typedef struct {
1270 [flag(NDR_BIG_ENDIAN)] ipv4address client_ip_address;
1271 uint32 unknown2;
1272 uint32 connection_time; /* in seconds */
1273 uint32 unknown4;
1274 uint32 unknown5;
1275 uint32 unknown6;
1277 * client_account can be the following:
1278 * "W2K3\Administrator"
1279 * "Administrator@W2K3"
1280 * "cn=Administrator,cn=Users,DC=w2k3,DC=vmnet1,DC=vm,DC=base"
1281 * ""
1282 * or NULL
1284 [charset(UTF16),string] uint16 *client_account;
1285 } drsuapi_DsGetDCConnection01;
1287 typedef struct {
1288 [range(0,10000)] uint32 count;
1289 [size_is(count)] drsuapi_DsGetDCConnection01 *array;
1290 } drsuapi_DsGetDCConnectionCtr01;
1292 typedef [switch_type(drsuapi_DsGetDCInfoCtrLevels)] union {
1293 [case(DRSUAPI_DC_INFO_CTR_1)] drsuapi_DsGetDCInfoCtr1 ctr1;
1294 [case(DRSUAPI_DC_INFO_CTR_2)] drsuapi_DsGetDCInfoCtr2 ctr2;
1295 [case(DRSUAPI_DC_INFO_CTR_3)] drsuapi_DsGetDCInfoCtr3 ctr3;
1296 [case(DRSUAPI_DC_CONNECTION_CTR_01)] drsuapi_DsGetDCConnectionCtr01 ctr01;
1297 } drsuapi_DsGetDCInfoCtr;
1299 WERROR drsuapi_DsGetDomainControllerInfo(
1300 [in] policy_handle *bind_handle,
1301 [in] uint32 level,
1302 [in,ref,switch_is(level)] drsuapi_DsGetDCInfoRequest *req,
1303 [out,ref] drsuapi_DsGetDCInfoCtrLevels *level_out,
1304 [out,ref,switch_is(*level_out)] drsuapi_DsGetDCInfoCtr *ctr
1307 /*****************/
1308 /* Function 0x11 */
1309 typedef [public,noprint] struct {
1310 drsuapi_DsReplicaObjectListItem *next_object;
1311 drsuapi_DsReplicaObject object;
1312 } drsuapi_DsReplicaObjectListItem;
1315 * The DsAddEntry() call which creates a nTDSDSA object,
1316 * also adds a servicePrincipalName in the following form
1317 * to the computer account of the new domain controller
1318 * referenced by the "serverReferenece" attribute.
1320 * E3514235-4B06-11D1-AB04-00C04FC2DCD2/<new-ntdsdsa-object-guid-as-string>/<domain-dns-name>
1322 * also note that the "serverReference" isn't added to the new object!
1324 const char *DRSUAPI_NTDSDSA_KRB5_SERVICE_GUID = "E3514235-4B06-11D1-AB04-00C04FC2DCD2";
1326 /* Error codes to classify an error that occurs
1327 * during a search for, or the update of,
1328 * a directory object */
1329 typedef [v1_enum] enum {
1330 DRSUAPI_DIRERR_OK = 0,
1331 DRSUAPI_DIRERR_ATTRIBUTE = 1,
1332 DRSUAPI_DIRERR_NAME = 2,
1333 DRSUAPI_DIRERR_REFERRAL = 3,
1334 DRSUAPI_DIRERR_SECURITY = 4,
1335 DRSUAPI_DIRERR_SERVICE = 5,
1336 DRSUAPI_DIRERR_UPDATE = 6,
1337 DRSUAPI_DIRERR_SYSTEM = 7
1338 } drsuapi_DsAddEntry_DirErr;
1341 * Ref: DRS_MSG_ADDENTRYREQ_V2, [MS-DRSR]: 4.1.1.1.3
1343 typedef struct {
1344 drsuapi_DsReplicaObjectListItem first_object;
1345 } drsuapi_DsAddEntryRequest2;
1347 /* Buffer type is actually more
1348 * like a semi Flags
1349 * Ref: DRS_SecBuffer, [MS-DRSR]: 5.41 */
1350 typedef [v1_enum,noprint] enum {
1351 DRSUAPI_SECBUFFER_EMPTY = 0x00000000,
1352 DRSUAPI_SECBUFFER_DATA = 0x00000001,
1353 DRSUAPI_SECBUFFER_TOKEN = 0x00000002,
1354 DRSUAPI_SECBUFFER_PKG_PARAMS = 0x00000003,
1355 DRSUAPI_SECBUFFER_MISSING = 0x00000004,
1356 DRSUAPI_SECBUFFER_EXTRA = 0x00000005,
1357 DRSUAPI_SECBUFFER_STREAM_TRAILER = 0x00000006,
1358 DRSUAPI_SECBUFFER_STREAM_HEADER = 0x00000007,
1359 DRSUAPI_SECBUFFER_READONLY = 0x80000000
1360 } drsuapi_SecBufferType;
1362 typedef struct {
1363 [range(0,10000)] uint32 buf_size;
1364 drsuapi_SecBufferType buf_type;
1365 [size_is(buf_size)] uint8 *buffer;
1366 } drsuapi_SecBuffer;
1368 typedef struct {
1369 [value(0)] uint32 version;
1370 [range(0,10000)] uint32 buff_count;
1371 [size_is(buff_count)] drsuapi_SecBuffer *buffers;
1372 } drsuapi_SecBufferDesc;
1375 * Ref: DRS_MSG_ADDENTRYREQ_V3, [MS-DRSR]: 4.1.1.1.4
1377 typedef struct {
1378 drsuapi_DsReplicaObjectListItem first_object;
1379 drsuapi_SecBufferDesc *client_creds;
1380 } drsuapi_DsAddEntryRequest3;
1382 typedef [switch_type(uint32)] union {
1383 [case(2)] drsuapi_DsAddEntryRequest2 req2;
1384 [case(3)] drsuapi_DsAddEntryRequest3 req3;
1385 } drsuapi_DsAddEntryRequest;
1387 /* Generic extended error info
1388 * commonly used in most places
1389 * where rich error info is returned */
1390 typedef struct {
1391 uint32 dsid; /* implementation-specific diagnostic code */
1392 WERROR extended_err; /* 0, STATUS code, or Windows error code */
1393 uint32 extended_data; /* implementation-specific diagnostic code */
1394 uint16 problem; /* 0 or PROBLEM error code */
1395 } drsuapi_DsAddEntryErrorInfoX;
1397 /* Attribute errors
1398 * Ref: ATRERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.11 */
1399 typedef struct {
1400 uint32 dsid;
1401 WERROR extended_err;
1402 uint32 extended_data;
1403 uint16 problem;
1404 drsuapi_DsAttributeId attid;
1405 boolean32 is_val_returned;
1406 drsuapi_DsAttributeValue attr_val;
1407 } drsuapi_DsAddEntry_AttrErr_V1;
1409 typedef [noprint] struct {
1410 drsuapi_DsAddEntry_AttrErrListItem_V1 *next;
1411 drsuapi_DsAddEntry_AttrErr_V1 err_data;
1412 } drsuapi_DsAddEntry_AttrErrListItem_V1;
1414 typedef struct {
1415 drsuapi_DsReplicaObjectIdentifier *id;
1416 uint32 count;
1417 drsuapi_DsAddEntry_AttrErrListItem_V1 first;
1418 } drsuapi_DsAddEntryErrorInfo_Attr_V1;
1420 /* Name resolution error
1421 * Ref: NAMERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.14 */
1422 typedef struct {
1423 uint32 dsid;
1424 WERROR extended_err;
1425 uint32 extended_data;
1426 uint16 problem;
1427 drsuapi_DsReplicaObjectIdentifier *id_matched; /* The best match for the supplied object identity */
1428 } drsuapi_DsAddEntryErrorInfo_Name_V1;
1430 /* Referral error
1431 * Ref: REFERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.15 */
1432 typedef struct {
1433 [value(83)] uint8 name_res; /* Must be 'S' */
1434 [value(0)] uint8 unused_pad;
1435 [value(0)] uint16 next_rdn;
1436 } drsuapi_NameResOp_V1;
1438 typedef [enum16bit] enum {
1439 DRSUAPI_CH_REFTYPE_SUPERIOR = 0x0000, /* referral to a superior DC */
1440 DRSUAPI_CH_REFTYPE_SUBORDINATE = 0x0001, /* referral to a subordinate DC */
1441 DRSUAPI_CH_REFTYPE_NSSR = 0x0002, /* Not used */
1442 DRSUAPI_CH_REFTYPE_CROSS = 0x0003 /* A referral to an external crossRef object */
1443 } drsuapi_DsAddEntry_RefType;
1445 typedef [enum8bit] enum {
1446 DRSUAPI_SE_CHOICE_BASE_ONLY = 0x00,
1447 DRSUAPI_SE_CHOICE_IMMED_CHLDRN = 0x01,
1448 DRSUAPI_SE_CHOICE_WHOLE_SUBTREE = 0x02
1449 } drsuapi_DsAddEntry_ChoiceType;
1451 /* list of network names of the DCs
1452 * to which the referral is directed */
1453 typedef struct {
1454 drsuapi_DsaAddressListItem_V1 *next;
1455 lsa_String *address;
1456 } drsuapi_DsaAddressListItem_V1;
1458 typedef struct {
1459 drsuapi_DsReplicaObjectIdentifier *id_target; /* object to which the referral is directed */
1460 drsuapi_NameResOp_V1 op_state;
1461 [value(0)] uint16 rdn_alias;
1462 [value(0)] uint16 rdn_internal;
1463 drsuapi_DsAddEntry_RefType ref_type;
1464 uint16 addr_list_count;
1465 drsuapi_DsaAddressListItem_V1 *addr_list;
1466 drsuapi_DsAddEntry_RefErrListItem_V1 *next;
1467 boolean32 is_choice_set;
1468 drsuapi_DsAddEntry_ChoiceType choice;
1469 } drsuapi_DsAddEntry_RefErrListItem_V1;
1471 typedef struct {
1472 uint32 dsid;
1473 WERROR extended_err;
1474 uint32 extended_data;
1475 drsuapi_DsAddEntry_RefErrListItem_V1 refer;
1476 } drsuapi_DsAddEntryErrorInfo_Referr_V1;
1478 typedef [switch_type(uint32)] union {
1479 [case(1)] drsuapi_DsAddEntryErrorInfo_Attr_V1 attr_err;
1480 [case(2)] drsuapi_DsAddEntryErrorInfo_Name_V1 name_err;
1481 [case(3)] drsuapi_DsAddEntryErrorInfo_Referr_V1 referral_err;
1482 [case(4)] drsuapi_DsAddEntryErrorInfoX security_err;
1483 [case(5)] drsuapi_DsAddEntryErrorInfoX service_err;
1484 [case(6)] drsuapi_DsAddEntryErrorInfoX update_err;
1485 [case(7)] drsuapi_DsAddEntryErrorInfoX system_err;
1486 } drsuapi_DsAddEntryErrorInfo;
1488 typedef struct {
1489 WERROR status;
1490 drsuapi_DsAddEntry_DirErr dir_err;
1491 [switch_is(dir_err)] drsuapi_DsAddEntryErrorInfo *info;
1492 } drsuapi_DsAddEntry_ErrData_V1;
1494 typedef [switch_type(uint32)] union {
1495 [case(1)] drsuapi_DsAddEntry_ErrData_V1 v1;
1496 } drsuapi_DsAddEntry_ErrData;
1498 typedef struct {
1499 GUID guid;
1500 dom_sid28 sid;
1501 } drsuapi_DsReplicaObjectIdentifier2;
1503 typedef struct {
1504 drsuapi_DsReplicaObjectIdentifier *id;
1505 drsuapi_DsAddEntry_DirErr dir_err;
1506 uint32 dsid; /* implementation-specific diagnostic code */
1507 WERROR extended_err; /* 0, STATUS code, or Windows error code */
1508 uint32 extended_data; /* implementation-specific diagnostic code */
1509 uint16 problem; /* 0 or PROBLEM error code */
1510 [range(0,10000)] uint32 count;
1511 [size_is(count)] drsuapi_DsReplicaObjectIdentifier2 *objects;
1512 } drsuapi_DsAddEntryCtr2;
1514 typedef struct {
1515 drsuapi_DsReplicaObjectIdentifier *id;
1516 uint32 err_ver; /* Must be 1 */
1517 [switch_is(err_ver)] drsuapi_DsAddEntry_ErrData *err_data;
1518 [range(0,10000)] uint32 count;
1519 [size_is(count)] drsuapi_DsReplicaObjectIdentifier2 *objects;
1520 } drsuapi_DsAddEntryCtr3;
1522 typedef [switch_type(uint32)] union {
1523 [case(2)] drsuapi_DsAddEntryCtr2 ctr2;
1524 [case(3)] drsuapi_DsAddEntryCtr3 ctr3;
1525 } drsuapi_DsAddEntryCtr;
1527 [public] WERROR drsuapi_DsAddEntry(
1528 [in] policy_handle *bind_handle,
1529 [in] uint32 level,
1530 [in,ref,switch_is(level)] drsuapi_DsAddEntryRequest *req,
1531 [out,ref] uint32 *level_out,
1532 [out,ref,switch_is(*level_out)] drsuapi_DsAddEntryCtr *ctr
1535 /*****************/
1536 /* Function 0x12 */
1537 typedef bitmap {
1538 DRSUAPI_DS_EXECUTE_KCC_ASYNCHRONOUS_OPERATION = 0x00000001,
1539 DRSUAPI_DS_EXECUTE_KCC_DAMPED = 0x00000002
1540 } drsuapi_DsExecuteKCCFlags;
1542 typedef struct {
1543 uint32 taskID;
1544 drsuapi_DsExecuteKCCFlags flags;
1545 } drsuapi_DsExecuteKCC1;
1547 typedef [switch_type(uint32)] union {
1548 [case(1)] drsuapi_DsExecuteKCC1 ctr1;
1549 } drsuapi_DsExecuteKCCRequest;
1551 WERROR drsuapi_DsExecuteKCC(
1552 [in] policy_handle *bind_handle,
1553 [in] uint32 level,
1554 [in, ref, switch_is(level)] drsuapi_DsExecuteKCCRequest *req
1557 /*****************/
1558 /* Function 0x13 */
1559 typedef [v1_enum] enum {
1560 DRSUAPI_DS_REPLICA_GET_INFO = 1,
1561 DRSUAPI_DS_REPLICA_GET_INFO2 = 2
1562 } drsuapi_DsReplicaGetInfoLevel;
1564 typedef [v1_enum] enum {
1565 DRSUAPI_DS_REPLICA_INFO_NEIGHBORS = 0,
1566 DRSUAPI_DS_REPLICA_INFO_CURSORS = 1,
1567 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA = 2,
1568 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES = 3,
1569 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES = 4,
1570 DRSUAPI_DS_REPLICA_INFO_PENDING_OPS = 5,
1571 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA = 6,
1572 DRSUAPI_DS_REPLICA_INFO_CURSORS2 = 7,
1573 DRSUAPI_DS_REPLICA_INFO_CURSORS3 = 8,
1574 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2 = 9,
1575 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2 = 10,
1576 DRSUAPI_DS_REPLICA_INFO_REPSTO = -2,
1577 DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS = -4,
1578 DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1 = -5,
1579 DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS = -6
1580 } drsuapi_DsReplicaInfoType;
1582 typedef struct {
1583 drsuapi_DsReplicaInfoType info_type;
1584 [charset(UTF16),string] uint16 *object_dn;
1585 GUID source_dsa_guid;
1586 } drsuapi_DsReplicaGetInfoRequest1;
1588 typedef struct {
1589 drsuapi_DsReplicaInfoType info_type;
1590 [charset(UTF16),string] uint16 *object_dn;
1591 GUID source_dsa_guid;
1592 uint32 flags;
1593 [charset(UTF16),string] uint16 *attribute_name;
1594 [charset(UTF16),string] uint16 *value_dn_str;
1595 uint32 enumeration_context;
1596 } drsuapi_DsReplicaGetInfoRequest2;
1598 typedef [switch_type(drsuapi_DsReplicaGetInfoLevel)] union {
1599 [case(DRSUAPI_DS_REPLICA_GET_INFO)] drsuapi_DsReplicaGetInfoRequest1 req1;
1600 [case(DRSUAPI_DS_REPLICA_GET_INFO2)] drsuapi_DsReplicaGetInfoRequest2 req2;
1601 } drsuapi_DsReplicaGetInfoRequest;
1603 typedef struct {
1604 [charset(UTF16),string] uint16 *naming_context_dn;
1605 [charset(UTF16),string] uint16 *source_dsa_obj_dn;
1606 [charset(UTF16),string] uint16 *source_dsa_address;
1607 [charset(UTF16),string] uint16 *transport_obj_dn;
1608 drsuapi_DrsOptions replica_flags;
1609 uint32 reserved;
1610 GUID naming_context_obj_guid;
1611 GUID source_dsa_obj_guid;
1612 GUID source_dsa_invocation_id;
1613 GUID transport_obj_guid;
1614 hyper tmp_highest_usn;
1615 hyper highest_usn;
1616 NTTIME last_success;
1617 NTTIME last_attempt;
1618 WERROR result_last_attempt;
1619 uint32 consecutive_sync_failures;
1620 } drsuapi_DsReplicaNeighbour;
1622 typedef struct {
1623 uint32 count;
1624 uint32 reserved;
1625 [size_is(count)] drsuapi_DsReplicaNeighbour array[];
1626 } drsuapi_DsReplicaNeighbourCtr;
1628 typedef struct {
1629 uint32 count;
1630 uint32 reserved;
1631 [size_is(count)] drsuapi_DsReplicaCursor array[];
1632 } drsuapi_DsReplicaCursorCtr;
1634 typedef struct {
1635 [charset(UTF16),string] uint16 *attribute_name;
1636 uint32 version;
1637 NTTIME originating_change_time;
1638 GUID originating_invocation_id;
1639 hyper originating_usn;
1640 hyper local_usn;
1641 } drsuapi_DsReplicaObjMetaData;
1643 typedef struct {
1644 uint32 count;
1645 uint32 reserved;
1646 [size_is(count)] drsuapi_DsReplicaObjMetaData array[];
1647 } drsuapi_DsReplicaObjMetaDataCtr;
1649 typedef struct {
1650 [charset(UTF16),string] uint16 *dsa_obj_dn;
1651 GUID dsa_obj_guid;
1652 NTTIME first_failure;
1653 uint32 num_failures;
1654 WERROR last_result;
1655 } drsuapi_DsReplicaKccDsaFailure;
1657 typedef struct {
1658 uint32 count;
1659 uint32 reserved;
1660 [size_is(count)] drsuapi_DsReplicaKccDsaFailure array[];
1661 } drsuapi_DsReplicaKccDsaFailuresCtr;
1663 typedef enum {
1664 DRSUAPI_DS_REPLICA_OP_TYPE_SYNC = 0,
1665 DRSUAPI_DS_REPLICA_OP_TYPE_ADD = 1,
1666 DRSUAPI_DS_REPLICA_OP_TYPE_DELETE = 2,
1667 DRSUAPI_DS_REPLICA_OP_TYPE_MODIFY = 3,
1668 DRSUAPI_DS_REPLICA_OP_TYPE_UPDATE_REFS = 4
1669 } drsuapi_DsReplicaOpType;
1671 typedef struct {
1672 NTTIME operation_start;
1673 uint32 serial_num; /* unique till reboot */
1674 uint32 priority;
1675 drsuapi_DsReplicaOpType operation_type;
1676 drsuapi_DrsOptions options;
1677 [charset(UTF16),string] uint16 *nc_dn;
1678 [charset(UTF16),string] uint16 *remote_dsa_obj_dn;
1679 [charset(UTF16),string] uint16 *remote_dsa_address;
1680 GUID nc_obj_guid;
1681 GUID remote_dsa_obj_guid;
1682 } drsuapi_DsReplicaOp;
1684 typedef struct {
1685 NTTIME time;
1686 uint32 count;
1687 [size_is(count)] drsuapi_DsReplicaOp array[];
1688 } drsuapi_DsReplicaOpCtr;
1690 typedef struct {
1691 [charset(UTF16),string] uint16 *attribute_name;
1692 [charset(UTF16),string] uint16 *object_dn;
1693 [value(ndr_size_DATA_BLOB(0,binary,0))] uint32 __ndr_size_binary;
1694 DATA_BLOB *binary;
1695 NTTIME deleted;
1696 NTTIME created;
1697 uint32 version;
1698 NTTIME originating_change_time;
1699 GUID originating_invocation_id;
1700 hyper originating_usn;
1701 hyper local_usn;
1702 } drsuapi_DsReplicaAttrValMetaData;
1704 typedef struct {
1705 uint32 count;
1706 uint32 enumeration_context;
1707 [size_is(count)] drsuapi_DsReplicaAttrValMetaData array[];
1708 } drsuapi_DsReplicaAttrValMetaDataCtr;
1710 typedef struct {
1711 uint32 count;
1712 uint32 enumeration_context;
1713 [size_is(count)] drsuapi_DsReplicaCursor2 array[];
1714 } drsuapi_DsReplicaCursor2Ctr;
1716 typedef struct {
1717 GUID source_dsa_invocation_id;
1718 hyper highest_usn;
1719 NTTIME last_sync_success;
1720 [charset(UTF16),string] uint16 *source_dsa_obj_dn;
1721 } drsuapi_DsReplicaCursor3;
1723 typedef struct {
1724 uint32 count;
1725 uint32 enumeration_context;
1726 [size_is(count)] drsuapi_DsReplicaCursor3 array[];
1727 } drsuapi_DsReplicaCursor3Ctr;
1729 typedef struct {
1730 [charset(UTF16),string] uint16 *attribute_name;
1731 uint32 version;
1732 NTTIME originating_change_time;
1733 GUID originating_invocation_id;
1734 hyper originating_usn;
1735 hyper local_usn;
1736 [charset(UTF16),string] uint16 *originating_dsa_dn;
1737 } drsuapi_DsReplicaObjMetaData2;
1739 typedef struct {
1740 uint32 count;
1741 uint32 enumeration_context;
1742 [size_is(count)] drsuapi_DsReplicaObjMetaData2 array[];
1743 } drsuapi_DsReplicaObjMetaData2Ctr;
1745 typedef struct {
1746 [charset(UTF16),string] uint16 *attribute_name;
1747 [charset(UTF16),string] uint16 *object_dn;
1748 [value(ndr_size_DATA_BLOB(0,binary,0))] uint32 __ndr_size_binary;
1749 DATA_BLOB *binary;
1750 NTTIME deleted;
1751 NTTIME created;
1752 uint32 version;
1753 NTTIME originating_change_time;
1754 GUID originating_invocation_id;
1755 hyper originating_usn;
1756 hyper local_usn;
1757 [charset(UTF16),string] uint16 *originating_dsa_dn;
1758 } drsuapi_DsReplicaAttrValMetaData2;
1760 typedef struct {
1761 uint32 count;
1762 uint32 enumeration_context;
1763 [size_is(count)] drsuapi_DsReplicaAttrValMetaData2 array[];
1764 } drsuapi_DsReplicaAttrValMetaData2Ctr;
1766 typedef struct {
1767 hyper u1; /* session number? */
1768 uint32 u2;
1769 uint32 u3;
1770 GUID bind_guid;
1771 NTTIME_1sec bind_time;
1772 [flag(NDR_BIG_ENDIAN)] ipv4address client_ip_address;
1773 uint32 u5; /* this is the same value the client used as pid in the DsBindInfoX struct */
1774 } drsuapi_DsReplicaConnection04;
1776 typedef struct {
1777 [range(0,10000)] uint32 count;
1778 uint32 reserved;
1779 [size_is(count)] drsuapi_DsReplicaConnection04 array[];
1780 } drsuapi_DsReplicaConnection04Ctr;
1782 typedef struct {
1783 [charset(UTF16),string] uint16 *str1;
1784 uint32 u1;
1785 uint32 u2;
1786 uint32 u3;
1787 uint32 u4;
1788 uint32 u5;
1789 hyper u6;
1790 uint32 u7;
1791 } drsuapi_DsReplica06;
1793 typedef struct {
1794 [range(0,256)] uint32 count;
1795 uint32 reserved;
1796 [size_is(count)] drsuapi_DsReplica06 array[];
1797 } drsuapi_DsReplica06Ctr;
1799 typedef [switch_type(drsuapi_DsReplicaInfoType)] union {
1800 [case(DRSUAPI_DS_REPLICA_INFO_NEIGHBORS)] drsuapi_DsReplicaNeighbourCtr *neighbours;
1801 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS)] drsuapi_DsReplicaCursorCtr *cursors;
1802 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA)] drsuapi_DsReplicaObjMetaDataCtr *objmetadata;
1803 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES)] drsuapi_DsReplicaKccDsaFailuresCtr *connectfailures;
1804 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES)] drsuapi_DsReplicaKccDsaFailuresCtr *linkfailures;
1805 [case(DRSUAPI_DS_REPLICA_INFO_PENDING_OPS)] drsuapi_DsReplicaOpCtr *pendingops;
1806 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA)] drsuapi_DsReplicaAttrValMetaDataCtr *attrvalmetadata;
1807 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS2)] drsuapi_DsReplicaCursor2Ctr *cursors2;
1808 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS3)] drsuapi_DsReplicaCursor3Ctr *cursors3;
1809 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2)] drsuapi_DsReplicaObjMetaData2Ctr *objmetadata2;
1810 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2)] drsuapi_DsReplicaAttrValMetaData2Ctr *attrvalmetadata2;
1811 [case(DRSUAPI_DS_REPLICA_INFO_REPSTO)] drsuapi_DsReplicaNeighbourCtr *repsto;
1812 [case(DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS)] drsuapi_DsReplicaConnection04Ctr *clientctx;
1813 [case(DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1)] drsuapi_DsReplicaCursorCtrEx *udv1;
1814 [case(DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS)] drsuapi_DsReplica06Ctr *srvoutgoingcalls;
1815 } drsuapi_DsReplicaInfo;
1817 WERROR drsuapi_DsReplicaGetInfo(
1818 [in] policy_handle *bind_handle,
1819 [in] drsuapi_DsReplicaGetInfoLevel level,
1820 [in,ref,switch_is(level)] drsuapi_DsReplicaGetInfoRequest *req,
1821 [out,ref] drsuapi_DsReplicaInfoType *info_type,
1822 [out,ref,switch_is(*info_type)] drsuapi_DsReplicaInfo *info
1825 /*****************/
1826 /* Function 0x14 */
1827 [todo] WERROR DRSUAPI_ADD_SID_HISTORY();
1829 /*****************/
1830 /* Function 0x15 */
1832 typedef struct {
1833 [range(0,10000)] uint32 num_entries;
1834 [size_is(num_entries)] drsuapi_DsGetMembershipsCtr1 **ctrl_array;
1835 } drsuapi_DsGetMemberships2Ctr1;
1837 typedef [switch_type(uint32)] union {
1838 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1;
1839 } drsuapi_DsGetMemberships2Ctr;
1841 typedef struct {
1842 [range(1,10000)] uint32 num_req;
1843 [size_is(num_req)] drsuapi_DsGetMembershipsRequest1 **req_array;
1844 } drsuapi_DsGetMemberships2Request1;
1846 typedef [switch_type(uint32)] union {
1847 [case(1)] drsuapi_DsGetMemberships2Request1 req1;
1848 } drsuapi_DsGetMemberships2Request;
1850 WERROR drsuapi_DsGetMemberships2(
1851 [in] policy_handle *bind_handle,
1852 [in] uint32 level,
1853 [in,ref] [switch_is(level)] drsuapi_DsGetMemberships2Request *req,
1854 [out,ref] uint32 *level_out,
1855 [out,ref] [switch_is(*level_out)] drsuapi_DsGetMemberships2Ctr *ctr
1858 /*****************/
1859 /* Function 0x16 */
1860 [todo] WERROR DRSUAPI_REPLICA_VERIFY_OBJECTS();
1862 /*****************/
1863 /* Function 0x17 */
1864 [todo] WERROR DRSUAPI_GET_OBJECT_EXISTENCE();
1866 /*****************/
1867 /* Function 0x18 */
1868 typedef struct {
1869 WERROR error_code;
1870 uint32 site_cost;
1871 } drsuapi_DsSiteCostInfo;
1873 typedef struct {
1874 [range(0,10000)] uint32 num_info;
1875 [size_is(num_info)] drsuapi_DsSiteCostInfo *info;
1876 [value(0)] uint32 flags_reserved;
1877 } drsuapi_QuerySitesByCostCtr1;
1879 typedef [switch_type(uint32)] union {
1880 [case(1)] drsuapi_QuerySitesByCostCtr1 ctr1;
1881 } drsuapi_QuerySitesByCostCtr;
1883 typedef struct {
1884 [charset(UTF16),string] uint16 *site_from;
1885 [range(1,10000)] uint32 num_req;
1886 [size_is(num_req)] [charset(UTF16),string] uint16 **site_to;
1887 uint32 flags;
1888 } drsuapi_QuerySitesByCostRequest1;
1890 typedef [switch_type(uint32)] union {
1891 [case(1)] drsuapi_QuerySitesByCostRequest1 req1;
1892 } drsuapi_QuerySitesByCostRequest;
1894 WERROR drsuapi_QuerySitesByCost(
1895 [in] policy_handle *bind_handle,
1896 [in] uint32 level,
1897 [in,ref] [switch_is(level)] drsuapi_QuerySitesByCostRequest *req,
1898 [out,ref] uint32 *level_out,
1899 [out,ref] [switch_is(*level_out)] drsuapi_QuerySitesByCostCtr *ctr