3 import
"security.idl", "misc.idl", "lsa.idl", "samr.idl";
6 uuid("e3514235-4b06-11d1-ab04-00c04fc2dcd2"),
8 endpoint("ncacn_np:[\\pipe\\lsass]","ncacn_np:[\\pipe\\protected_storage]", "ncacn_ip_tcp:", "ncalrpc:"),
10 helpstring("Active Directory Replication"),
11 helper
("../librpc/ndr/ndr_drsuapi.h"),
12 pointer_default(unique)
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
61 /* see DRS_MSG_REPMOD_V1 */
62 typedef [public,bitmap32bit
] bitmap
{
63 DRSUAPI_DRS_UPDATE_FLAGS
= 0x00000001,
64 DRSUAPI_DRS_UPDATE_ADDRESS
= 0x00000002,
65 DRSUAPI_DRS_UPDATE_SCHEDULE
= 0x00000004
70 typedef [bitmap32bit
] bitmap
{
71 DRSUAPI_SUPPORTED_EXTENSION_BASE
= 0x00000001,
72 DRSUAPI_SUPPORTED_EXTENSION_ASYNC_REPLICATION
= 0x00000002,
73 DRSUAPI_SUPPORTED_EXTENSION_REMOVEAPI
= 0x00000004,
74 DRSUAPI_SUPPORTED_EXTENSION_MOVEREQ_V2
= 0x00000008,
75 DRSUAPI_SUPPORTED_EXTENSION_GETCHG_COMPRESS
= 0x00000010,
76 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V1
= 0x00000020,
77 DRSUAPI_SUPPORTED_EXTENSION_RESTORE_USN_OPTIMIZATION
= 0x00000040,
78 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY
= 0x00000080,
79 DRSUAPI_SUPPORTED_EXTENSION_KCC_EXECUTE
= 0x00000100,
80 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY_V2
= 0x00000200,
81 DRSUAPI_SUPPORTED_EXTENSION_LINKED_VALUE_REPLICATION
= 0x00000400,
82 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V2
= 0x00000800,
83 DRSUAPI_SUPPORTED_EXTENSION_INSTANCE_TYPE_NOT_REQ_ON_MOD
= 0x00001000,
84 DRSUAPI_SUPPORTED_EXTENSION_CRYPTO_BIND
= 0x00002000,
85 DRSUAPI_SUPPORTED_EXTENSION_GET_REPL_INFO
= 0x00004000,
86 DRSUAPI_SUPPORTED_EXTENSION_STRONG_ENCRYPTION
= 0x00008000,
87 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V01
= 0x00010000,
88 DRSUAPI_SUPPORTED_EXTENSION_TRANSITIVE_MEMBERSHIP
= 0x00020000,
89 DRSUAPI_SUPPORTED_EXTENSION_ADD_SID_HISTORY
= 0x00040000,
90 DRSUAPI_SUPPORTED_EXTENSION_POST_BETA3
= 0x00080000,
91 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V5
= 0x00100000,
92 DRSUAPI_SUPPORTED_EXTENSION_GET_MEMBERSHIPS2
= 0x00200000,
93 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V6
= 0x00400000,
94 DRSUAPI_SUPPORTED_EXTENSION_NONDOMAIN_NCS
= 0x00800000,
95 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V8
= 0x01000000,
96 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V5
= 0x02000000,
97 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V6
= 0x04000000,
99 * the following 3 have the same value
100 * repadmin.exe /bind says that
102 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRYREPLY_V3
= 0x08000000,
103 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V7
= 0x08000000,
104 DRSUAPI_SUPPORTED_EXTENSION_VERIFY_OBJECT
= 0x08000000,
105 DRSUAPI_SUPPORTED_EXTENSION_XPRESS_COMPRESS
= 0x10000000,
106 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V10
= 0x20000000,
107 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART2
= 0x40000000,
108 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART3
= 0x80000000
109 } drsuapi_SupportedExtensions
;
111 typedef [bitmap32bit
] bitmap
{
112 DRSUAPI_SUPPORTED_EXTENSION_ADAM
= 0x00000001,
113 DRSUAPI_SUPPORTED_EXTENSION_LH_BETA2
= 0x00000002,
114 DRSUAPI_SUPPORTED_EXTENSION_RECYCLE_BIN
= 0x00000004
115 } drsuapi_SupportedExtensionsExt
;
117 /* this is used by w2k */
118 typedef [public] struct {
119 drsuapi_SupportedExtensions supported_extensions
;
122 } drsuapi_DsBindInfo24
;
124 /* this is used by w2k3 */
125 typedef [public] struct {
126 drsuapi_SupportedExtensions supported_extensions
;
130 } drsuapi_DsBindInfo28
;
132 typedef [public] struct {
133 drsuapi_SupportedExtensions supported_extensions
;
137 drsuapi_SupportedExtensionsExt supported_extensions_ext
;
138 } drsuapi_DsBindInfo32
;
140 /* this is used by w2k8 */
141 typedef [public] struct {
142 drsuapi_SupportedExtensions supported_extensions
;
146 drsuapi_SupportedExtensionsExt supported_extensions_ext
;
148 } drsuapi_DsBindInfo48
;
150 /* this is used by w2k12 R2 [MS-DRSR] Section 5.39 */
151 typedef [public] struct {
152 drsuapi_SupportedExtensions supported_extensions
;
156 drsuapi_SupportedExtensionsExt supported_extensions_ext
;
158 drsuapi_SupportedExtensionsExt supported_capabilities_ext
;
159 } drsuapi_DsBindInfo52
;
161 typedef [public] struct {
162 [flag
(NDR_REMAINING
)] DATA_BLOB info
;
163 } drsuapi_DsBindInfoFallBack
;
165 typedef [nopull
, nopush
, noprint
] [nodiscriminant
] union {
166 [case(24)][subcontext
(0), subcontext_size
(24)] drsuapi_DsBindInfo24 info24
;
167 [case(28)][subcontext
(0), subcontext_size
(28)] drsuapi_DsBindInfo28 info28
;
168 [case(32)][subcontext
(0), subcontext_size
(32)] drsuapi_DsBindInfo32 info32
;
169 [case(48)][subcontext
(0), subcontext_size
(48)] drsuapi_DsBindInfo48 info48
;
170 [case(52)][subcontext
(0), subcontext_size
(52)] drsuapi_DsBindInfo52 info52
;
172 * The size for the defaut case is a bit arbitrary it in fact the value
173 * of the switch but we can't reference it.
174 * As we hand(un-)marshall this structure it has 0 impact and makes
175 * pidl happy for wireshark too
177 [default][subcontext
(0), subcontext_size
(48)] drsuapi_DsBindInfoFallBack Fallback
;
178 } drsuapi_DsBindInfo
;
180 /* the drsuapi_DsBindInfoCtr was this before
181 * typedef [flag(NDR_PAHEX)] struct {
182 * [range(1,10000)] uint32 length;
183 * [size_is(length)] uint8 data[];
184 * } drsuapi_DsBindInfo;
186 * but we don't want the caller to manually decode this blob,
187 * so we're doing it here
191 * MS-DRSR.pdf gives the following definition
193 [range(1,10000)] DWORD cb;
194 [size_is(cb)] BYTE rgb[];
197 But we use a subcontext which has a slighly different signification on how
199 With the MS-DRSR definition we will have
200 size_is_cb cv rgb_array
201 with size_is_cb being a uint3264 and cv being a uint32
205 [range(1,10000)] uint32 length;
206 [switch_is(length)] drsuapi_DsBindInfo info;
207 } drsuapi_DsBindInfoCtr;
209 typedef [nodiscriminant] union {
210 [case(24)][subcontext(4)] drsuapi_DsBindInfo24 info24;
211 [case(28)][subcontext(4)] drsuapi_DsBindInfo28 info28;
212 [case(48)][subcontext(4)] drsuapi_DsBindInfo48 info48;
213 [default][subcontext(4)] drsuapi_DsBindInfoFallBack FallBack;
214 } drsuapi_DsBindInfo;
216 With this definition data is laid out this way:
217 length subcontext_size drsuapi_DsBindInfoxx
218 with length being a uint32 and subcontext_size being a uint3264
220 It has clearly an impact on the way things are aligned when using NDR64
222 typedef [flag
(NDR_NOALIGN
)] struct {
223 [range(1,10000)] uint3264 length
;
224 [value
(length
)] uint32 __ndr_length
;
225 [switch_is(length
)] drsuapi_DsBindInfo info
;
226 } drsuapi_DsBindInfoCtr
;
228 /* this is a magic guid you need to pass to DsBind to make drsuapi_DsWriteAccountSpn() work
230 * maybe the bind_guid could also be the invocation_id see drsuapi_DsReplicaConnection04
232 const char *DRSUAPI_DS_BIND_GUID
= "e24d201a-4fd6-11d1-a3da-0000f875ae0d";
234 * this magic guid are needed to fetch the whole tree with drsuapi_DsGetNCChanges()
235 * as administrator and this values are also used in the destination_dsa_guid field
236 * of drsuapi_DsGetNCChangesReq5/8 and the source_dsa_guid is zero.
238 const char *DRSUAPI_DS_BIND_GUID_W2K
= "6abec3d1-3054-41c8-a362-5a0c5b7d5d71";
239 const char *DRSUAPI_DS_BIND_GUID_W2K3
= "6afab99c-6e26-464a-975f-f58f105218bc";
241 [public] WERROR drsuapi_DsBind
(
242 [in,unique] GUID
*bind_guid
,
243 [in,out,unique] drsuapi_DsBindInfoCtr
*bind_info
,
244 [out] policy_handle
*bind_handle
249 WERROR drsuapi_DsUnbind
(
250 [in,out] policy_handle
*bind_handle
255 typedef [public,gensize
] struct {
256 [value
(ndr_size_drsuapi_DsReplicaObjectIdentifier
(r
, ndr
->flags
)-4)] uint32 __ndr_size
;
257 [value
(ndr_size_dom_sid28
(&sid
, ndr
->flags
))] uint32 __ndr_size_sid
;
260 [value
(strlen_m
(dn
))] uint32 __ndr_size_dn
;
261 [charset
(UTF16
),size_is(__ndr_size_dn
+1)] uint16 dn
[];
262 } drsuapi_DsReplicaObjectIdentifier
;
265 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
266 GUID source_dsa_guid
;
267 [charset
(DOS
),string] char *source_dsa_dns
; /* Source DSA dns_name in <guid>._msdcs.<domain_dns> form */
268 drsuapi_DrsOptions options
;
269 } drsuapi_DsReplicaSyncRequest1
;
271 typedef [switch_type(uint32
)] union {
272 [case(1)] drsuapi_DsReplicaSyncRequest1 req1
;
273 } drsuapi_DsReplicaSyncRequest
;
275 WERROR drsuapi_DsReplicaSync
(
276 [in] policy_handle
*bind_handle
,
278 [in,switch_is(level
)] drsuapi_DsReplicaSyncRequest
*req
283 typedef [public] struct {
284 hyper tmp_highest_usn
; /* updated after each object update */
286 hyper highest_usn
; /* updated after a full replication cycle */
287 } drsuapi_DsReplicaHighWaterMark
;
289 typedef [public] struct {
290 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
291 hyper highest_usn
; /* updated after a full replication cycle */
292 } drsuapi_DsReplicaCursor
;
295 [value
(1)] uint32
version;
296 [value
(0)] uint32 reserved1
;
297 [range(0,0x100000)] uint32 count
;
298 [value
(0)] uint32 reserved2
;
299 [size_is(count
)] drsuapi_DsReplicaCursor cursors
[];
300 } drsuapi_DsReplicaCursorCtrEx
;
302 typedef [flag
(NDR_PAHEX
),v1_enum] enum {
303 DRSUAPI_EXOP_NONE
= 0x00000000,
304 DRSUAPI_EXOP_FSMO_REQ_ROLE
= 0x00000001,
305 DRSUAPI_EXOP_FSMO_RID_ALLOC
= 0x00000002,
306 DRSUAPI_EXOP_FSMO_RID_REQ_ROLE
= 0x00000003,
307 DRSUAPI_EXOP_FSMO_REQ_PDC
= 0x00000004,
308 DRSUAPI_EXOP_FSMO_ABANDON_ROLE
= 0x00000005,
309 DRSUAPI_EXOP_REPL_OBJ
= 0x00000006,
310 DRSUAPI_EXOP_REPL_SECRET
= 0x00000007
311 } drsuapi_DsExtendedOperation
;
313 typedef [flag
(NDR_PAHEX
),v1_enum] enum {
314 DRSUAPI_EXOP_ERR_NONE
= 0x00000000,
315 DRSUAPI_EXOP_ERR_SUCCESS
= 0x00000001,
316 DRSUAPI_EXOP_ERR_UNKNOWN_OP
= 0x00000002,
317 DRSUAPI_EXOP_ERR_FSMO_NOT_OWNER
= 0x00000003,
318 DRSUAPI_EXOP_ERR_UPDATE_ERR
= 0x00000004,
319 DRSUAPI_EXOP_ERR_EXCEPTION
= 0x00000005,
320 DRSUAPI_EXOP_ERR_UNKNOWN_CALLER
= 0x00000006,
321 DRSUAPI_EXOP_ERR_RID_ALLOC
= 0x00000007,
322 DRSUAPI_EXOP_ERR_FSMO_OWNER_DELETED
= 0x00000008,
323 DRSUAPI_EXOP_ERR_FMSO_PENDING_OP
= 0x00000009,
324 DRSUAPI_EXOP_ERR_MISMATCH
= 0x0000000A,
325 DRSUAPI_EXOP_ERR_COULDNT_CONTACT
= 0x0000000B,
326 DRSUAPI_EXOP_ERR_FSMO_REFUSING_ROLES
= 0x0000000C,
327 DRSUAPI_EXOP_ERR_DIR_ERROR
= 0x0000000D,
328 DRSUAPI_EXOP_ERR_FSMO_MISSING_SETTINGS
= 0x0000000E,
329 DRSUAPI_EXOP_ERR_ACCESS_DENIED
= 0x0000000F,
330 DRSUAPI_EXOP_ERR_PARAM_ERROR
= 0x00000010
331 } drsuapi_DsExtendedError
;
334 GUID destination_dsa_guid
;
335 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
336 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
337 drsuapi_DsReplicaHighWaterMark highwatermark
;
338 drsuapi_DsReplicaCursorCtrEx
*uptodateness_vector
;
339 drsuapi_DrsOptions replica_flags
;
340 uint32 max_object_count
; /* w2k3 uses min(133,max(100,max_object_count)) */
341 uint32 max_ndr_size
; /* w2k3 seems to ignore this */
342 drsuapi_DsExtendedOperation extended_op
;
344 } drsuapi_DsGetNCChangesRequest5
;
347 * In DRSUAPI all attributes with syntax 2.5.5.2
348 * are identified by uint32 values
350 * the following table shows the mapping used between the two representations
351 * e.g. - objectClass 'nTDSDSA' has governsID: 1.2.840.113556.1.5.7000.47
352 * and a UINT32-ID of '0x0017002F'.
353 * - so the OID 1.2.840.113556.1.5.7000.47 is splitted into a
354 * OID-prefix: 1.2.840.113556.1.5.7000
355 * and a value: 47 => 0x2F
356 * - the mapping table gives a UINT32-prefix: 0x00170000
357 * - and the UINT32-ID is 0x0017002F = 0x00170000 | 0x2F
359 * This prefix mapping table is replied in the drsuapi_DsReplicaOIDMapping_Ctr
360 * array. The following are the default mappings of w2k3
362 * OID-prefix => UINT32-Id prefix
364 * 2.5.4.* => 0x00000000 (standard attributes RFC2256 core.schema)
365 * 2.5.6.* => 0x00010000 (standard object classes RFC2256 core.schema)
366 * 1.2.840.113556.1.2.* => 0x00020000
367 * 1.2.840.113556.1.3.* => 0x00030000
368 * 2.5.5.* => 0x00080000 (attributeSyntax OID's)
369 * 1.2.840.113556.1.4.* => 0x00090000
370 * 1.2.840.113556.1.5.* => 0x000A0000
371 * 2.16.840.1.113730.3.* => 0x00140000
372 * 0.9.2342.19200300.100.1.* => 0x00150000
373 * 2.16.840.1.113730.3.1.* => 0x00160000
374 * 1.2.840.113556.1.5.7000.* => 0x00170000
375 * 2.5.21.* => 0x00180000 (attrs for SubSchema)
376 * 2.5.18.* => 0x00190000 (createTimeStamp,modifyTimeStamp, SubSchema)
377 * 2.5.20.* => 0x001A0000
378 * 1.3.6.1.4.1.1466.101.119.* => 0x001B0000 (dynamicObject, entryTTL)
379 * 2.16.840.1.113730.3.2.* => 0x001C0000
380 * 1.3.6.1.4.1.250.1.* => 0x001D0000
381 * 1.2.840.113549.1.9.* => 0x001E0000 (unstructuredAddress,unstructuredName)
382 * 0.9.2342.19200300.100.4.* => 0x001F0000
384 * Here's a list of used 'attributeSyntax' OID's
386 * 2.5.5.1 => Object(DS-DN) string
387 * struct drsuapi_DsObjectIdentifier3
389 * 2.5.5.2 => OID-string
390 * => all values are represented as uint32 values in drsuapi
391 * => governsID, attributeID and attributeSyntax returned as OID-Strings in LDAP
392 * => mayContain, mustContain and all other attributes with 2.5.5.2 syntax
393 * are returned as attribute names
395 * 2.5.5.4 => String(Teletex) case-insensitive string with teletex charset
397 * 2.5.5.5 => String(IA5) case-sensitive string
399 * 2.5.5.6 => String(Numeric)
400 * => eg. internationalISDNNumber
402 * 2.5.5.7 => Object(DN-Binary) B:<byte count>:<bytes>:<object DN>
403 * => e.g. wellKnownObjects
409 * 2.5.5.10 => DATA_BLOB
412 * 2.5.5.11 => LDAP timestring
415 * 2.5.5.12 => String(Unicode) case-insensitive string
416 * => 'standard strings'
418 * 2.5.5.13 => Object(Presentation-Address) string
419 * => used in objectClass applicationEntity
421 * 2.5.5.14 => Object(DN-String) S:<char count>:<string>:<object DN>
424 * 2.5.5.15 => ntSecurityDescriptor
428 * 2.5.5.17 => dom_sid
430 typedef [noprint
] struct {
431 [range(0,10000)] uint32 length
;
432 [size_is(length
)] uint8
*binary_oid
; /* partial-binary-OID encoded with asn1_write_partial_OID_String() */
433 } drsuapi_DsReplicaOID
;
437 drsuapi_DsReplicaOID oid
;
438 } drsuapi_DsReplicaOIDMapping
;
440 typedef [public] struct {
441 [range(0,0x100000)] uint32 num_mappings
;
442 [size_is(num_mappings
)] drsuapi_DsReplicaOIDMapping
*mappings
;
443 } drsuapi_DsReplicaOIDMapping_Ctr
;
445 typedef [flag
(NDR_PAHEX
),v1_enum] enum {
446 DRSUAPI_OBJECTCLASS_top
= 0x00010000,
447 DRSUAPI_OBJECTCLASS_classSchema
= 0x0003000d,
448 DRSUAPI_OBJECTCLASS_attributeSchema
= 0x0003000e
449 } drsuapi_DsObjectClassId
;
451 typedef [flag
(NDR_PAHEX
),v1_enum,public] enum {
452 DRSUAPI_ATTID_objectClass
= 0x00000000,
453 DRSUAPI_ATTID_cn
= 0x00000003,
454 DRSUAPI_ATTID_ou
= 0x0000000b,
455 DRSUAPI_ATTID_description
= 0x0000000d,
456 DRSUAPI_ATTID_member
= 0x0000001f,
457 DRSUAPI_ATTID_instanceType
= 0x00020001,
458 DRSUAPI_ATTID_whenCreated
= 0x00020002,
459 DRSUAPI_ATTID_possSuperiors
= 0x00020008,
460 DRSUAPI_ATTID_displayName
= 0x0002000d,
461 DRSUAPI_ATTID_hasMasterNCs
= 0x0002000e,
462 DRSUAPI_ATTID_nCName
= 0x00020010,
463 DRSUAPI_ATTID_subClassOf
= 0x00020015,
464 DRSUAPI_ATTID_governsID
= 0x00020016,
465 DRSUAPI_ATTID_mustContain
= 0x00020018,
466 DRSUAPI_ATTID_mayContain
= 0x00020019,
467 DRSUAPI_ATTID_rDNAttId
= 0x0002001A,
468 DRSUAPI_ATTID_attributeID
= 0x0002001e,
469 DRSUAPI_ATTID_attributeSyntax
= 0x00020020,
470 DRSUAPI_ATTID_isSingleValued
= 0x00020021,
471 DRSUAPI_ATTID_rangeLower
= 0x00020022,
472 DRSUAPI_ATTID_rangeUpper
= 0x00020023,
473 DRSUAPI_ATTID_dMDLocation
= 0x00020024,
474 DRSUAPI_ATTID_isDeleted
= 0x00020030,
475 DRSUAPI_ATTID_objectVersion
= 0x0002004c,
476 DRSUAPI_ATTID_invocationId
= 0x00020073,
477 DRSUAPI_ATTID_showInAdvancedViewOnly
= 0x000200a9,
478 DRSUAPI_ATTID_adminDisplayName
= 0x000200c2,
479 DRSUAPI_ATTID_adminDescription
= 0x000200e2,
480 DRSUAPI_ATTID_oMSyntax
= 0x000200e7,
481 DRSUAPI_ATTID_ntSecurityDescriptor
= 0x00020119,
482 DRSUAPI_ATTID_searchFlags
= 0x0002014e,
483 DRSUAPI_ATTID_auxiliaryClass
= 0x0002015f,
484 DRSUAPI_ATTID_lDAPDisplayName
= 0x000201cc,
485 DRSUAPI_ATTID_name
= 0x00090001,
486 DRSUAPI_ATTID_objectGUID
= 0x00090002,
487 DRSUAPI_ATTID_replPropertyMetaData
= 0x00090003,
488 DRSUAPI_ATTID_userAccountControl
= 0x00090008,
489 DRSUAPI_ATTID_badPwdCount
= 0x0009000c,
490 DRSUAPI_ATTID_codePage
= 0x00090010,
491 DRSUAPI_ATTID_countryCode
= 0x00090019,
492 DRSUAPI_ATTID_currentValue
= 0x0009001b,
493 DRSUAPI_ATTID_homeDirectory
= 0x0009002c,
494 DRSUAPI_ATTID_homeDrive
= 0x0009002d,
495 DRSUAPI_ATTID_lastLogoff
= 0x00090033,
496 DRSUAPI_ATTID_lastLogon
= 0x00090034,
497 DRSUAPI_ATTID_dBCSPwd
= 0x00090037,/* lmPwdHash */
498 DRSUAPI_ATTID_scriptPath
= 0x0009003e,
499 DRSUAPI_ATTID_logonHours
= 0x00090040,
500 DRSUAPI_ATTID_userWorkstations
= 0x00090056,
501 DRSUAPI_ATTID_unicodePwd
= 0x0009005a,/* ntPwdHash */
502 DRSUAPI_ATTID_ntPwdHistory
= 0x0009005e,
503 DRSUAPI_ATTID_pwdLastSet
= 0x00090060,
504 DRSUAPI_ATTID_primaryGroupID
= 0x00090062,
505 DRSUAPI_ATTID_priorValue
= 0x00090064,
506 DRSUAPI_ATTID_supplementalCredentials
= 0x0009007d,
507 DRSUAPI_ATTID_trustAuthIncoming
= 0x00090081,
508 DRSUAPI_ATTID_trustAuthOutgoing
= 0x00090087,
509 DRSUAPI_ATTID_userParameters
= 0x0009008a,
510 DRSUAPI_ATTID_profilePath
= 0x0009008b,
511 DRSUAPI_ATTID_objectSid
= 0x00090092,
512 DRSUAPI_ATTID_schemaIDGUID
= 0x00090094,
513 DRSUAPI_ATTID_comment
= 0x0009009C,/* User-Comment */
514 DRSUAPI_ATTID_accountExpires
= 0x0009009f,
515 DRSUAPI_ATTID_lmPwdHistory
= 0x000900a0,
516 DRSUAPI_ATTID_logonCount
= 0x000900a9,
517 DRSUAPI_ATTID_systemPossSuperiors
= 0x000900c3,
518 DRSUAPI_ATTID_systemMayContain
= 0x000900c4,
519 DRSUAPI_ATTID_systemMustContain
= 0x000900c5,
520 DRSUAPI_ATTID_systemAuxiliaryClass
= 0x000900c6,
521 DRSUAPI_ATTID_sAMAccountName
= 0x000900dd,
522 DRSUAPI_ATTID_sAMAccountType
= 0x0009012e,
523 DRSUAPI_ATTID_options
= 0x00090133,
524 DRSUAPI_ATTID_fSMORoleOwner
= 0x00090171,
525 DRSUAPI_ATTID_systemFlags
= 0x00090177,
526 DRSUAPI_ATTID_serverReference
= 0x00090203,
527 DRSUAPI_ATTID_serverReferenceBL
= 0x00090204,
528 DRSUAPI_ATTID_nonSecurityMember
= 0x00090212,
529 DRSUAPI_ATTID_initialAuthIncoming
= 0x0009021b,
530 DRSUAPI_ATTID_initialAuthOutgoing
= 0x0009021c,
531 DRSUAPI_ATTID_wellKnownObjects
= 0x0009026a,
532 DRSUAPI_ATTID_dNSHostName
= 0x0009026b,
533 DRSUAPI_ATTID_isMemberOfPartialAttributeSet
= 0x0009027f,
534 DRSUAPI_ATTID_managedBy
= 0x0009028d,
535 DRSUAPI_ATTID_userPrincipalName
= 0x00090290,
536 DRSUAPI_ATTID_groupType
= 0x000902ee,
537 DRSUAPI_ATTID_servicePrincipalName
= 0x00090303,
538 DRSUAPI_ATTID_lastKnownParent
= 0x0009030d,
539 DRSUAPI_ATTID_objectCategory
= 0x0009030e,
540 DRSUAPI_ATTID_gPLink
= 0x0009037b,
541 DRSUAPI_ATTID_transportAddressAttribute
= 0x0009037f,
542 DRSUAPI_ATTID_msDS_Behavior_Version
= 0x000905b3,
543 DRSUAPI_ATTID_msDS_KeyVersionNumber
= 0x000906f6,
544 DRSUAPI_ATTID_msDS_HasDomainNCs
= 0x0009071c,
545 DRSUAPI_ATTID_msDS_hasMasterNCs
= 0x0009072c,
546 DRSUAPI_ATTID_isRecycled
= 0x0009080a,
548 DRSUAPI_ATTID_INVALID
= 0xFFFFFFFF
549 } drsuapi_DsAttributeId
;
552 [value
(1)] uint32
version;
553 [value
(0)] uint32 reserved1
;
554 [range(1,0x100000)] uint32 num_attids
;
555 [size_is(num_attids
)] drsuapi_DsAttributeId attids
[];
556 } drsuapi_DsPartialAttributeSet
;
559 GUID destination_dsa_guid
;
560 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
561 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
562 drsuapi_DsReplicaHighWaterMark highwatermark
;
563 drsuapi_DsReplicaCursorCtrEx
*uptodateness_vector
;
564 drsuapi_DrsOptions replica_flags
;
565 uint32 max_object_count
; /* w2k3 uses min(133,max(100,max_object_count)) */
566 uint32 max_ndr_size
; /* w2k3 seems to ignore this */
567 drsuapi_DsExtendedOperation extended_op
;
569 drsuapi_DsPartialAttributeSet
*partial_attribute_set
;
570 drsuapi_DsPartialAttributeSet
*partial_attribute_set_ex
;
571 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr
;
572 } drsuapi_DsGetNCChangesRequest8
;
575 GUID destination_dsa_guid
;
576 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
577 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
578 drsuapi_DsReplicaHighWaterMark highwatermark
;
579 drsuapi_DsReplicaCursorCtrEx
*uptodateness_vector
;
580 drsuapi_DrsOptions replica_flags
;
581 uint32 max_object_count
; /* w2k3 uses min(133,max(100,max_object_count)) */
582 uint32 max_ndr_size
; /* w2k3 seems to ignore this */
583 drsuapi_DsExtendedOperation extended_op
;
585 drsuapi_DsPartialAttributeSet
*partial_attribute_set
;
586 drsuapi_DsPartialAttributeSet
*partial_attribute_set_ex
;
587 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr
;
589 } drsuapi_DsGetNCChangesRequest10
;
591 typedef [switch_type(uint32
)] union {
592 [case(5)] drsuapi_DsGetNCChangesRequest5 req5
;
593 [case(8)] drsuapi_DsGetNCChangesRequest8 req8
;
594 [case(10)] drsuapi_DsGetNCChangesRequest10 req10
;
595 } drsuapi_DsGetNCChangesRequest
;
597 typedef [public] struct {
598 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
599 hyper highest_usn
; /* updated after a full replication cycle */
600 NTTIME last_sync_success
;
601 } drsuapi_DsReplicaCursor2
;
604 [value
(2)] uint32
version;
605 [value
(0)] uint32 reserved1
;
606 [range(0,0x100000)] uint32 count
;
607 [value
(0)] uint32 reserved2
;
608 [size_is(count
)] drsuapi_DsReplicaCursor2 cursors
[];
609 } drsuapi_DsReplicaCursor2CtrEx
;
611 /* Generic DATA_BLOB values */
613 [range(0,26214400),value
(ndr_size_DATA_BLOB
(0,blob
,0))] uint32 __ndr_size
;
615 } drsuapi_DsAttributeValue
;
618 [range(0,10485760)] uint32 num_values
;
619 [size_is(num_values
)] drsuapi_DsAttributeValue
*values
;
620 } drsuapi_DsAttributeValueCtr
;
622 /* DN String values */
623 typedef [public,gensize
] struct {
624 [value
(ndr_size_drsuapi_DsReplicaObjectIdentifier3
(r
, ndr
->flags
))] uint32 __ndr_size
;
625 [value
(ndr_size_dom_sid28
(&sid
,ndr
->flags
))] uint32 __ndr_size_sid
;
628 [value
(strlen_m
(dn
))] uint32 __ndr_size_dn
;
629 [charset
(UTF16
)] uint16 dn
[__ndr_size_dn
+1];
630 } drsuapi_DsReplicaObjectIdentifier3
;
632 typedef [public] struct {
633 [value
(ndr_size_drsuapi_DsReplicaObjectIdentifier3Binary_without_Binary
(r
, ndr
->flags
))] uint32 __ndr_size
;
634 [value
(ndr_size_dom_sid28
(&sid
,ndr
->flags
))] uint32 __ndr_size_sid
;
637 [value
(strlen_m
(dn
))] uint32 __ndr_size_dn
;
638 [charset
(UTF16
)] uint16 dn
[__ndr_size_dn
+1];
639 [value
(binary.length
+ 4)] uint32 __ndr_size_binary
;
640 [flag
(NDR_REMAINING
)] DATA_BLOB binary
;
641 } drsuapi_DsReplicaObjectIdentifier3Binary
;
643 typedef [public,noprint
] struct {
644 drsuapi_DsAttributeId attid
;
645 drsuapi_DsAttributeValueCtr value_ctr
;
646 } drsuapi_DsReplicaAttribute
;
649 [range(0,1048576)] uint32 num_attributes
;
650 [size_is(num_attributes
)] drsuapi_DsReplicaAttribute
*attributes
;
651 } drsuapi_DsReplicaAttributeCtr
;
653 typedef [public] bitmap
{
654 DRSUAPI_DS_REPLICA_OBJECT_FROM_MASTER
= 0x00000001,
655 DRSUAPI_DS_REPLICA_OBJECT_DYNAMIC
= 0x00000002,
656 DRSUAPI_DS_REPLICA_OBJECT_REMOTE_MODIFY
= 0x00010000
657 } drsuapi_DsReplicaObjectFlags
;
659 typedef [public] struct {
660 drsuapi_DsReplicaObjectIdentifier
*identifier
;
661 drsuapi_DsReplicaObjectFlags flags
;
662 drsuapi_DsReplicaAttributeCtr attribute_ctr
;
663 } drsuapi_DsReplicaObject
;
667 NTTIME_1sec originating_change_time
;
668 GUID originating_invocation_id
;
669 hyper originating_usn
;
670 } drsuapi_DsReplicaMetaData
;
672 typedef [public] struct {
673 [range(0,1048576)] uint32 count
;
674 [size_is(count
)] drsuapi_DsReplicaMetaData meta_data
[];
675 } drsuapi_DsReplicaMetaDataCtr
;
677 typedef [public,noprint
] struct {
678 drsuapi_DsReplicaObjectListItemEx
*next_object
;
679 drsuapi_DsReplicaObject
object;
680 boolean32 is_nc_prefix
;
681 GUID
*parent_object_guid
;
682 drsuapi_DsReplicaMetaDataCtr
*meta_data_ctr
;
683 } drsuapi_DsReplicaObjectListItemEx
;
685 typedef [public,gensize
] struct {
686 GUID source_dsa_guid
; /* the 'objectGUID' field of the CN=NTDS Settings object */
687 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
688 drsuapi_DsReplicaObjectIdentifier
*naming_context
;
689 drsuapi_DsReplicaHighWaterMark old_highwatermark
;
690 drsuapi_DsReplicaHighWaterMark new_highwatermark
;
691 drsuapi_DsReplicaCursorCtrEx
*uptodateness_vector
;
692 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr
;
693 drsuapi_DsExtendedError extended_ret
; /* w2k sends the nc_object_count value here */
695 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
696 [value
(ndr_size_drsuapi_DsGetNCChangesCtr1
(r
,ndr
->flags
)+55)] uint32 __ndr_size
;
697 drsuapi_DsReplicaObjectListItemEx
*first_object
;
699 } drsuapi_DsGetNCChangesCtr1
;
702 * if the DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE flag
703 * isn't there it means the value is deleted
705 typedef [public] bitmap
{
706 DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE
= 0x00000001
707 } drsuapi_DsLinkedAttributeFlags
;
709 typedef [public] struct {
710 drsuapi_DsReplicaObjectIdentifier
*identifier
;
711 drsuapi_DsAttributeId attid
;
712 drsuapi_DsAttributeValue value
;
713 drsuapi_DsLinkedAttributeFlags flags
;
714 NTTIME_1sec originating_add_time
;
715 drsuapi_DsReplicaMetaData meta_data
;
716 } drsuapi_DsReplicaLinkedAttribute
;
718 /* [MS-DRSR] section 4.1.10.2.11 DRS_MSG_GETCHGREPLY_V6 */
719 typedef [public,gensize
] struct {
720 GUID source_dsa_guid
; /* the 'objectGUID' field of the CN=NTDS Settings object */
721 GUID source_dsa_invocation_id
; /* the 'invocationId' field of the CN=NTDS Settings object */
722 drsuapi_DsReplicaObjectIdentifier
*naming_context
;
723 drsuapi_DsReplicaHighWaterMark old_highwatermark
;
724 drsuapi_DsReplicaHighWaterMark new_highwatermark
;
725 drsuapi_DsReplicaCursor2CtrEx
*uptodateness_vector
;
726 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr
;
727 drsuapi_DsExtendedError extended_ret
;
729 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
730 [value
(ndr_size_drsuapi_DsGetNCChangesCtr6
(r
,ndr
->flags
)+55)] uint32 __ndr_size
;
731 drsuapi_DsReplicaObjectListItemEx
*first_object
;
733 uint32 nc_object_count
; /* estimated amount of objects in the whole NC */
734 uint32 nc_linked_attributes_count
; /* estimated amount of linked values in the whole NC */
735 [range(0,1048576)] uint32 linked_attributes_count
;
736 [size_is(linked_attributes_count
)] drsuapi_DsReplicaLinkedAttribute
*linked_attributes
;
738 } drsuapi_DsGetNCChangesCtr6
;
740 typedef [public] struct {
741 [subcontext
(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr1 ctr1
;
742 } drsuapi_DsGetNCChangesCtr1TS
;
744 typedef [public] struct {
745 [subcontext
(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr6 ctr6
;
746 } drsuapi_DsGetNCChangesCtr6TS
;
748 typedef [nopush
] struct {
749 uint32 decompressed_length
;
750 uint32 compressed_length
;
751 [subcontext
(4),subcontext_size
(compressed_length
),
752 compression
(NDR_COMPRESSION_MSZIP
,compressed_length
,decompressed_length
)]
753 drsuapi_DsGetNCChangesCtr1TS
*ts
;
754 } drsuapi_DsGetNCChangesMSZIPCtr1
;
756 typedef [nopush
] struct {
757 uint32 decompressed_length
;
758 uint32 compressed_length
;
759 [subcontext
(4),subcontext_size
(compressed_length
),
760 compression
(NDR_COMPRESSION_MSZIP
,compressed_length
,decompressed_length
)]
761 drsuapi_DsGetNCChangesCtr6TS
*ts
;
762 } drsuapi_DsGetNCChangesMSZIPCtr6
;
764 typedef [nopush
] struct {
765 uint32 decompressed_length
;
766 uint32 compressed_length
;
767 [subcontext
(4),subcontext_size
(compressed_length
),
768 compression
(NDR_COMPRESSION_XPRESS
,compressed_length
,decompressed_length
)]
769 drsuapi_DsGetNCChangesCtr1TS
*ts
;
770 } drsuapi_DsGetNCChangesXPRESSCtr1
;
772 typedef [nopush
] struct {
773 uint32 decompressed_length
;
774 uint32 compressed_length
;
775 [subcontext
(4),subcontext_size
(compressed_length
),
776 compression
(NDR_COMPRESSION_XPRESS
,compressed_length
,decompressed_length
)]
777 drsuapi_DsGetNCChangesCtr6TS
*ts
;
778 } drsuapi_DsGetNCChangesXPRESSCtr6
;
780 typedef [enum16bit
] enum {
781 DRSUAPI_COMPRESSION_TYPE_MSZIP
= 2,
782 DRSUAPI_COMPRESSION_TYPE_XPRESS
= 3
783 } drsuapi_DsGetNCChangesCompressionType
;
785 typedef [nodiscriminant
,flag
(NDR_PAHEX
)] union {
786 [case(1|
(DRSUAPI_COMPRESSION_TYPE_MSZIP
<<16))] drsuapi_DsGetNCChangesMSZIPCtr1 mszip1
;
787 [case(6|
(DRSUAPI_COMPRESSION_TYPE_MSZIP
<<16))] drsuapi_DsGetNCChangesMSZIPCtr6 mszip6
;
788 [case(1|
(DRSUAPI_COMPRESSION_TYPE_XPRESS
<<16))] drsuapi_DsGetNCChangesXPRESSCtr1 xpress1
;
789 [case(6|
(DRSUAPI_COMPRESSION_TYPE_XPRESS
<<16))] drsuapi_DsGetNCChangesXPRESSCtr6 xpress6
;
790 } drsuapi_DsGetNCChangesCompressedCtr
;
793 drsuapi_DsGetNCChangesMSZIPCtr1 mszip1
;
794 } drsuapi_DsGetNCChangesCtr2
;
797 [range(0,6)] uint32 level
;
798 [range(2,3)] drsuapi_DsGetNCChangesCompressionType type
;
799 [switch_is(level |
(type
<<16))] drsuapi_DsGetNCChangesCompressedCtr ctr
;
800 } drsuapi_DsGetNCChangesCtr7
;
802 typedef [switch_type(uint32
)] union {
803 [case(1)] drsuapi_DsGetNCChangesCtr1 ctr1
;
804 [case(2)] drsuapi_DsGetNCChangesCtr2 ctr2
;
805 [case(6)] drsuapi_DsGetNCChangesCtr6 ctr6
;
806 [case(7)] drsuapi_DsGetNCChangesCtr7 ctr7
;
807 } drsuapi_DsGetNCChangesCtr
;
809 WERROR drsuapi_DsGetNCChanges
(
810 [in] policy_handle
*bind_handle
,
812 [in,ref,switch_is(level
)] drsuapi_DsGetNCChangesRequest
*req
,
813 [out,ref] uint32
*level_out
,
814 [out,ref,switch_is(*level_out
)] drsuapi_DsGetNCChangesCtr
*ctr
819 /* [MS-DRSR] 4.1.26 */
822 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
823 [ref,charset
(DOS
),string] uint8
*dest_dsa_dns_name
;
825 drsuapi_DrsOptions options
;
826 } drsuapi_DsReplicaUpdateRefsRequest1
;
828 typedef [switch_type(uint32
)] union {
829 [case(1)] drsuapi_DsReplicaUpdateRefsRequest1 req1
;
830 } drsuapi_DsReplicaUpdateRefsRequest
;
832 WERROR drsuapi_DsReplicaUpdateRefs
(
833 [in] policy_handle
*bind_handle
,
835 [in,switch_is(level
)] drsuapi_DsReplicaUpdateRefsRequest req
842 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
843 [charset
(UTF16
),string] uint16
*source_dsa_address
;
845 drsuapi_DrsOptions options
;
846 } drsuapi_DsReplicaAddRequest1
;
849 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
850 drsuapi_DsReplicaObjectIdentifier
*source_dsa_dn
;
851 drsuapi_DsReplicaObjectIdentifier
*transport_dn
;
852 [charset
(UTF16
),string] uint16
*source_dsa_address
;
854 drsuapi_DrsOptions options
;
855 } drsuapi_DsReplicaAddRequest2
;
857 typedef [switch_type(uint32
)] union {
858 [case(1)] drsuapi_DsReplicaAddRequest1 req1
;
859 [case(2)] drsuapi_DsReplicaAddRequest2 req2
;
860 } drsuapi_DsReplicaAddRequest
;
862 WERROR drsuapi_DsReplicaAdd
(
863 [in] policy_handle
*bind_handle
,
865 [in,switch_is(level
)] drsuapi_DsReplicaAddRequest req
872 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
873 [charset
(UTF8
), string] uint8
*source_dsa_address
;
874 drsuapi_DrsOptions options
;
875 } drsuapi_DsReplicaDelRequest1
;
877 typedef [switch_type(uint32
)] union {
878 [case(1)] drsuapi_DsReplicaDelRequest1 req1
;
879 } drsuapi_DsReplicaDelRequest
;
881 WERROR drsuapi_DsReplicaDel
(
882 [in] policy_handle
*bind_handle
,
884 [in,switch_is(level
)] drsuapi_DsReplicaDelRequest req
891 [ref] drsuapi_DsReplicaObjectIdentifier
*naming_context
;
893 [charset
(UTF16
),string] uint16
*source_dra_address
;
895 drsuapi_DrsOptions replica_flags
;
896 uint32 modify_fields
;
897 drsuapi_DrsOptions options
;
898 } drsuapi_DsReplicaModRequest1
;
900 typedef [switch_type(uint32
)] union {
901 [case(1)] drsuapi_DsReplicaModRequest1 req1
;
902 } drsuapi_DsReplicaModRequest
;
904 WERROR drsuapi_DsReplicaMod
(
905 [in] policy_handle
*bind_handle
,
907 [in,switch_is(level
)] drsuapi_DsReplicaModRequest req
912 [todo
] WERROR DRSUAPI_VERIFY_NAMES
();
917 /* how are type 4 and 7 different from 2 and 3 ? */
918 typedef [v1_enum] enum {
919 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_AND_DOMAIN_GROUPS
= 1,
920 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS
= 2,
921 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS
= 3,
922 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS2
= 4,
923 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_GROUPS
= 5,
924 DRSUAPI_DS_MEMBERSHIP_TYPE_GROUPMEMBERS
= 6,
925 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS2
= 7
926 } drsuapi_DsMembershipType
;
930 [range(0,10000)] uint32 num_memberships
;
931 [range(0,10000)] uint32 num_sids
;
932 [size_is(num_memberships
)] drsuapi_DsReplicaObjectIdentifier
**info_array
;
933 [size_is(num_memberships
)] samr_GroupAttrs
*group_attrs
;
934 [size_is(num_sids
)] dom_sid28
**sids
;
935 } drsuapi_DsGetMembershipsCtr1
;
937 typedef [switch_type(uint32
)] union {
938 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1
;
939 } drsuapi_DsGetMembershipsCtr
;
941 const int DRSUAPI_DS_MEMBERSHIP_FLAG_GROUP_ATTR
= 0x1;
944 [range(1,10000)] uint32 count
;
945 [size_is(count
)] drsuapi_DsReplicaObjectIdentifier
**info_array
;
947 [range(1,7)] drsuapi_DsMembershipType type
;
948 drsuapi_DsReplicaObjectIdentifier
*domain
;
949 } drsuapi_DsGetMembershipsRequest1
;
951 typedef [switch_type(uint32
)] union {
952 [case(1)] drsuapi_DsGetMembershipsRequest1 req1
;
953 } drsuapi_DsGetMembershipsRequest
;
955 WERROR drsuapi_DsGetMemberships
(
956 [in] policy_handle
*bind_handle
,
958 [in,ref] [switch_is(level
)] drsuapi_DsGetMembershipsRequest
*req
,
959 [out,ref] uint32
*level_out
,
960 [out,ref] [switch_is(*level_out
)] drsuapi_DsGetMembershipsCtr
*ctr
965 [todo
] WERROR DRSUAPI_INTER_DOMAIN_MOVE
();
969 typedef [bitmap32bit
] bitmap
{
970 DRSUAPI_NT4_CHANGELOG_GET_CHANGELOG
= 0x00000001,
971 DRSUAPI_NT4_CHANGELOG_GET_SERIAL_NUMBERS
= 0x00000002
972 } drsuapi_DsGetNT4ChangeLogFlags
;
975 drsuapi_DsGetNT4ChangeLogFlags flags
;
976 uint32 preferred_maximum_length
;
977 [range(0,0x00A00000)] uint32 restart_length
;
978 [size_is(restart_length
)] uint8
*restart_data
;
979 } drsuapi_DsGetNT4ChangeLogRequest1
;
981 typedef [switch_type(uint32
)] union {
982 [case(1)] drsuapi_DsGetNT4ChangeLogRequest1 req1
;
983 } drsuapi_DsGetNT4ChangeLogRequest
;
986 [range(0,0x00A00000)] uint32 restart_length
;
987 [range(0,0x00A00000)] uint32 log_length
;
988 hyper sam_serial_number
;
989 NTTIME sam_creation_time
;
990 hyper builtin_serial_number
;
991 NTTIME builtin_creation_time
;
992 hyper lsa_serial_number
;
993 NTTIME lsa_creation_time
;
995 [size_is(restart_length
)] uint8
*restart_data
;
996 [size_is(log_length
)] uint8
*log_data
;
997 } drsuapi_DsGetNT4ChangeLogInfo1
;
999 typedef [switch_type(uint32
)] union {
1000 [case(1)] drsuapi_DsGetNT4ChangeLogInfo1 info1
;
1001 } drsuapi_DsGetNT4ChangeLogInfo
;
1003 WERROR drsuapi_DsGetNT4ChangeLog
(
1004 [in] policy_handle
*bind_handle
,
1006 [in,ref] [switch_is(level
)] drsuapi_DsGetNT4ChangeLogRequest
*req
,
1007 [out,ref] uint32
*level_out
,
1008 [out,ref] [switch_is(*level_out
)] drsuapi_DsGetNT4ChangeLogInfo
*info
1013 typedef [v1_enum] enum {
1014 DRSUAPI_DS_NAME_STATUS_OK
= 0,
1015 DRSUAPI_DS_NAME_STATUS_RESOLVE_ERROR
= 1,
1016 DRSUAPI_DS_NAME_STATUS_NOT_FOUND
= 2,
1017 DRSUAPI_DS_NAME_STATUS_NOT_UNIQUE
= 3,
1018 DRSUAPI_DS_NAME_STATUS_NO_MAPPING
= 4,
1019 DRSUAPI_DS_NAME_STATUS_DOMAIN_ONLY
= 5,
1020 DRSUAPI_DS_NAME_STATUS_NO_SYNTACTICAL_MAPPING
= 6,
1021 DRSUAPI_DS_NAME_STATUS_TRUST_REFERRAL
= 7
1022 } drsuapi_DsNameStatus
;
1024 typedef [v1_enum] enum {
1025 DRSUAPI_DS_NAME_FLAG_NO_FLAGS
= 0x0,
1026 DRSUAPI_DS_NAME_FLAG_SYNTACTICAL_ONLY
= 0x1,
1027 DRSUAPI_DS_NAME_FLAG_EVAL_AT_DC
= 0x2,
1028 DRSUAPI_DS_NAME_FLAG_GCVERIFY
= 0x4,
1029 DRSUAPI_DS_NAME_FLAG_TRUST_REFERRAL
= 0x8
1030 } drsuapi_DsNameFlags
;
1032 typedef [v1_enum] enum {
1033 DRSUAPI_DS_NAME_FORMAT_UNKNOWN
= 0x00000000,
1034 DRSUAPI_DS_NAME_FORMAT_FQDN_1779
= 0x00000001,
1035 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT
= 0x00000002,
1036 DRSUAPI_DS_NAME_FORMAT_DISPLAY
= 0x00000003,
1037 DRSUAPI_DS_NAME_FORMAT_GUID
= 0x00000006,
1038 DRSUAPI_DS_NAME_FORMAT_CANONICAL
= 0x00000007,
1039 DRSUAPI_DS_NAME_FORMAT_USER_PRINCIPAL
= 0x00000008,
1040 DRSUAPI_DS_NAME_FORMAT_CANONICAL_EX
= 0x00000009,
1041 DRSUAPI_DS_NAME_FORMAT_SERVICE_PRINCIPAL
= 0x0000000A,
1042 DRSUAPI_DS_NAME_FORMAT_SID_OR_SID_HISTORY
= 0x0000000B,
1043 DRSUAPI_DS_NAME_FORMAT_DNS_DOMAIN
= 0x0000000C,
1044 DRSUAPI_DS_NAME_FORMAT_UPN_AND_ALTSECID
= 0xFFFFFFEF,
1045 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN_EX
= 0xFFFFFFF0,
1046 DRSUAPI_DS_NAME_FORMAT_LIST_GLOBAL_CATALOG_SERVERS
= 0xFFFFFFF1,
1047 DRSUAPI_DS_NAME_FORMAT_UPN_FOR_LOGON
= 0xFFFFFFF2,
1048 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_WITH_DCS_IN_SITE
= 0xFFFFFFF3,
1049 DRSUAPI_DS_NAME_FORMAT_STRING_SID_NAME
= 0xFFFFFFF4,
1050 DRSUAPI_DS_NAME_FORMAT_ALT_SECURITY_IDENTITIES_NAME
= 0xFFFFFFF5,
1051 DRSUAPI_DS_NAME_FORMAT_LIST_NCS
= 0xFFFFFFF6,
1052 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS
= 0xFFFFFFF7,
1053 DRSUAPI_DS_NAME_FORMAT_MAP_SCHEMA_GUID
= 0xFFFFFFF8,
1054 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN
= 0xFFFFFFF9,
1055 DRSUAPI_DS_NAME_FORMAT_LIST_ROLES
= 0xFFFFFFFA,
1056 DRSUAPI_DS_NAME_FORMAT_LIST_INFO_FOR_SERVER
= 0xFFFFFFFB,
1057 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_FOR_DOMAIN_IN_SITE
= 0xFFFFFFFC,
1058 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS_IN_SITE
= 0xFFFFFFFD,
1059 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_IN_SITE
= 0xFFFFFFFE,
1060 DRSUAPI_DS_NAME_FORMAT_LIST_SITES
= 0xFFFFFFFF
1061 } drsuapi_DsNameFormat
;
1064 [string,charset
(UTF16
)] uint16
*str
;
1065 } drsuapi_DsNameString
;
1068 uint32 codepage
; /* 0x000004e4 - 1252 is german codepage*/
1069 uint32 language
; /* 0x00000407 - german language ID*/
1070 drsuapi_DsNameFlags format_flags
;
1071 drsuapi_DsNameFormat format_offered
;
1072 drsuapi_DsNameFormat format_desired
;
1073 [range(1,10000)] uint32 count
;
1074 [size_is(count
)] drsuapi_DsNameString
*names
;
1075 } drsuapi_DsNameRequest1
;
1077 typedef [switch_type(uint32
)] union {
1078 [case(1)] drsuapi_DsNameRequest1 req1
;
1079 } drsuapi_DsNameRequest
;
1082 drsuapi_DsNameStatus status
;
1083 [charset
(UTF16
),string] uint16
*dns_domain_name
;
1084 [charset
(UTF16
),string] uint16
*result_name
;
1085 } drsuapi_DsNameInfo1
;
1089 [size_is(count
)] drsuapi_DsNameInfo1
*array
;
1090 } drsuapi_DsNameCtr1
;
1092 typedef [switch_type(uint32
)] union {
1093 [case(1)] drsuapi_DsNameCtr1
*ctr1
;
1094 } drsuapi_DsNameCtr
;
1096 WERROR drsuapi_DsCrackNames
(
1097 [in] policy_handle
*bind_handle
,
1099 [in,ref,switch_is(level
)] drsuapi_DsNameRequest
*req
,
1100 [out,ref] uint32
*level_out
,
1101 [out,ref,switch_is(*level_out
)] drsuapi_DsNameCtr
*ctr
1106 typedef [v1_enum] enum {
1107 DRSUAPI_DS_SPN_OPERATION_ADD
= 0,
1108 DRSUAPI_DS_SPN_OPERATION_REPLACE
= 1,
1109 DRSUAPI_DS_SPN_OPERATION_DELETE
= 2
1110 } drsuapi_DsSpnOperation
;
1113 drsuapi_DsSpnOperation operation
;
1115 [charset
(UTF16
),string] uint16
*object_dn
;
1116 [range(0,10000)] uint32 count
;
1117 [size_is(count
)] drsuapi_DsNameString
*spn_names
;
1118 } drsuapi_DsWriteAccountSpnRequest1
;
1120 typedef [switch_type(uint32
)] union {
1121 [case(1)] drsuapi_DsWriteAccountSpnRequest1 req1
;
1122 } drsuapi_DsWriteAccountSpnRequest
;
1126 } drsuapi_DsWriteAccountSpnResult1
;
1128 typedef [switch_type(uint32
)] union {
1129 [case(1)] drsuapi_DsWriteAccountSpnResult1 res1
;
1130 } drsuapi_DsWriteAccountSpnResult
;
1132 WERROR drsuapi_DsWriteAccountSpn
(
1133 [in] policy_handle
*bind_handle
,
1135 [in,ref,switch_is(level
)] drsuapi_DsWriteAccountSpnRequest
*req
,
1136 [out,ref] uint32
*level_out
,
1137 [out,ref,switch_is(*level_out
)] drsuapi_DsWriteAccountSpnResult
*res
1143 [charset
(UTF16
),string] uint16
*server_dn
;
1144 [charset
(UTF16
),string] uint16
*domain_dn
;
1146 } drsuapi_DsRemoveDSServerRequest1
;
1148 typedef [switch_type(uint32
)] union {
1149 [case(1)] drsuapi_DsRemoveDSServerRequest1 req1
;
1150 } drsuapi_DsRemoveDSServerRequest
;
1153 boolean32 last_dc_in_domain
;
1154 } drsuapi_DsRemoveDSServerResult1
;
1156 typedef [switch_type(uint32
)] union {
1157 [case(1)] drsuapi_DsRemoveDSServerResult1 res1
;
1158 } drsuapi_DsRemoveDSServerResult
;
1160 WERROR drsuapi_DsRemoveDSServer
(
1161 [in] policy_handle
*bind_handle
,
1163 [in,ref,switch_is(level
)] drsuapi_DsRemoveDSServerRequest
*req
,
1164 [out,ref] uint32
*level_out
,
1165 [out,ref,switch_is(*level_out
)] drsuapi_DsRemoveDSServerResult
*res
1170 [todo
] WERROR DRSUAPI_REMOVE_DS_DOMAIN
();
1174 typedef [v1_enum] enum {
1175 DRSUAPI_DC_INFO_CTR_1
= 1,
1176 DRSUAPI_DC_INFO_CTR_2
= 2,
1177 DRSUAPI_DC_INFO_CTR_3
= 3,
1178 DRSUAPI_DC_CONNECTION_CTR_01
= 0xFFFFFFFF
1179 } drsuapi_DsGetDCInfoCtrLevels
;
1182 [charset
(UTF16
),string] uint16
*domain_name
; /* netbios or dns */
1183 drsuapi_DsGetDCInfoCtrLevels level
; /* specifies the switch level for the request */
1184 } drsuapi_DsGetDCInfoRequest1
;
1186 typedef [switch_type(uint32
)] union {
1187 [case(1)] drsuapi_DsGetDCInfoRequest1 req1
;
1188 } drsuapi_DsGetDCInfoRequest
;
1191 [charset
(UTF16
),string] uint16
*netbios_name
;
1192 [charset
(UTF16
),string] uint16
*dns_name
;
1193 [charset
(UTF16
),string] uint16
*site_name
;
1194 [charset
(UTF16
),string] uint16
*computer_dn
;
1195 [charset
(UTF16
),string] uint16
*server_dn
;
1198 } drsuapi_DsGetDCInfo1
;
1201 [range(0,10000)] uint32 count
;
1202 [size_is(count
)] drsuapi_DsGetDCInfo1
*array
;
1203 } drsuapi_DsGetDCInfoCtr1
;
1206 [charset
(UTF16
),string] uint16
*netbios_name
;
1207 [charset
(UTF16
),string] uint16
*dns_name
;
1208 [charset
(UTF16
),string] uint16
*site_name
;
1209 [charset
(UTF16
),string] uint16
*site_dn
;
1210 [charset
(UTF16
),string] uint16
*computer_dn
;
1211 [charset
(UTF16
),string] uint16
*server_dn
;
1212 [charset
(UTF16
),string] uint16
*ntds_dn
;
1220 } drsuapi_DsGetDCInfo2
;
1223 [range(0,10000)] uint32 count
;
1224 [size_is(count
)] drsuapi_DsGetDCInfo2
*array
;
1225 } drsuapi_DsGetDCInfoCtr2
;
1228 [charset
(UTF16
),string] uint16
*netbios_name
;
1229 [charset
(UTF16
),string] uint16
*dns_name
;
1230 [charset
(UTF16
),string] uint16
*site_name
;
1231 [charset
(UTF16
),string] uint16
*site_dn
;
1232 [charset
(UTF16
),string] uint16
*computer_dn
;
1233 [charset
(UTF16
),string] uint16
*server_dn
;
1234 [charset
(UTF16
),string] uint16
*ntds_dn
;
1243 } drsuapi_DsGetDCInfo3
;
1246 [range(0,10000)] uint32 count
;
1247 [size_is(count
)] drsuapi_DsGetDCInfo3
*array
;
1248 } drsuapi_DsGetDCInfoCtr3
;
1251 * this represents an active connection to the
1252 * Directory System Agent (DSA)
1253 * this can be via LDAP or DRSUAPI
1256 [flag
(NDR_BIG_ENDIAN
)] ipv4address client_ip_address
;
1258 uint32 connection_time
; /* in seconds */
1263 * client_account can be the following:
1264 * "W2K3\Administrator"
1265 * "Administrator@W2K3"
1266 * "cn=Administrator,cn=Users,DC=w2k3,DC=vmnet1,DC=vm,DC=base"
1270 [charset
(UTF16
),string] uint16
*client_account
;
1271 } drsuapi_DsGetDCConnection01
;
1274 [range(0,10000)] uint32 count
;
1275 [size_is(count
)] drsuapi_DsGetDCConnection01
*array
;
1276 } drsuapi_DsGetDCConnectionCtr01
;
1278 typedef [switch_type(drsuapi_DsGetDCInfoCtrLevels
)] union {
1279 [case(DRSUAPI_DC_INFO_CTR_1
)] drsuapi_DsGetDCInfoCtr1 ctr1
;
1280 [case(DRSUAPI_DC_INFO_CTR_2
)] drsuapi_DsGetDCInfoCtr2 ctr2
;
1281 [case(DRSUAPI_DC_INFO_CTR_3
)] drsuapi_DsGetDCInfoCtr3 ctr3
;
1282 [case(DRSUAPI_DC_CONNECTION_CTR_01
)] drsuapi_DsGetDCConnectionCtr01 ctr01
;
1283 } drsuapi_DsGetDCInfoCtr
;
1285 WERROR drsuapi_DsGetDomainControllerInfo
(
1286 [in] policy_handle
*bind_handle
,
1288 [in,ref,switch_is(level
)] drsuapi_DsGetDCInfoRequest
*req
,
1289 [out,ref] drsuapi_DsGetDCInfoCtrLevels
*level_out
,
1290 [out,ref,switch_is(*level_out
)] drsuapi_DsGetDCInfoCtr
*ctr
1295 typedef [public,noprint
] struct {
1296 drsuapi_DsReplicaObjectListItem
*next_object
;
1297 drsuapi_DsReplicaObject
object;
1298 } drsuapi_DsReplicaObjectListItem
;
1301 * The DsAddEntry() call which creates a nTDSDSA object,
1302 * also adds a servicePrincipalName in the following form
1303 * to the computer account of the new domain controller
1304 * referenced by the "serverReferenece" attribute.
1306 * E3514235-4B06-11D1-AB04-00C04FC2DCD2/<new-ntdsdsa-object-guid-as-string>/<domain-dns-name>
1308 * also note that the "serverReference" isn't added to the new object!
1310 const char *DRSUAPI_NTDSDSA_KRB5_SERVICE_GUID
= "E3514235-4B06-11D1-AB04-00C04FC2DCD2";
1312 /* Error codes to classify an error that occurs
1313 * during a search for, or the update of,
1314 * a directory object */
1315 typedef [v1_enum] enum {
1316 DRSUAPI_DIRERR_OK
= 0,
1317 DRSUAPI_DIRERR_ATTRIBUTE
= 1,
1318 DRSUAPI_DIRERR_NAME
= 2,
1319 DRSUAPI_DIRERR_REFERRAL
= 3,
1320 DRSUAPI_DIRERR_SECURITY
= 4,
1321 DRSUAPI_DIRERR_SERVICE
= 5,
1322 DRSUAPI_DIRERR_UPDATE
= 6,
1323 DRSUAPI_DIRERR_SYSTEM
= 7
1324 } drsuapi_DsAddEntry_DirErr
;
1327 * Ref: DRS_MSG_ADDENTRYREQ_V2, [MS-DRSR]: 4.1.1.1.3
1330 drsuapi_DsReplicaObjectListItem first_object
;
1331 } drsuapi_DsAddEntryRequest2
;
1333 /* Buffer type is actually more
1335 * Ref: DRS_SecBuffer, [MS-DRSR]: 5.41 */
1336 typedef [v1_enum,noprint
] enum {
1337 DRSUAPI_SECBUFFER_EMPTY
= 0x00000000,
1338 DRSUAPI_SECBUFFER_DATA
= 0x00000001,
1339 DRSUAPI_SECBUFFER_TOKEN
= 0x00000002,
1340 DRSUAPI_SECBUFFER_PKG_PARAMS
= 0x00000003,
1341 DRSUAPI_SECBUFFER_MISSING
= 0x00000004,
1342 DRSUAPI_SECBUFFER_EXTRA
= 0x00000005,
1343 DRSUAPI_SECBUFFER_STREAM_TRAILER
= 0x00000006,
1344 DRSUAPI_SECBUFFER_STREAM_HEADER
= 0x00000007,
1345 DRSUAPI_SECBUFFER_READONLY
= 0x80000000
1346 } drsuapi_SecBufferType
;
1349 [range(0,10000)] uint32 buf_size
;
1350 drsuapi_SecBufferType buf_type
;
1351 [size_is(buf_size
)] uint8
*buffer
;
1352 } drsuapi_SecBuffer
;
1355 [value
(0)] uint32
version;
1356 [range(0,10000)] uint32 buff_count
;
1357 [size_is(buff_count
)] drsuapi_SecBuffer
*buffers
;
1358 } drsuapi_SecBufferDesc
;
1361 * Ref: DRS_MSG_ADDENTRYREQ_V3, [MS-DRSR]: 4.1.1.1.4
1364 drsuapi_DsReplicaObjectListItem first_object
;
1365 drsuapi_SecBufferDesc
*client_creds
;
1366 } drsuapi_DsAddEntryRequest3
;
1368 typedef [switch_type(uint32
)] union {
1369 [case(2)] drsuapi_DsAddEntryRequest2 req2
;
1370 [case(3)] drsuapi_DsAddEntryRequest3 req3
;
1371 } drsuapi_DsAddEntryRequest
;
1373 /* Generic extended error info
1374 * commonly used in most places
1375 * where rich error info is returned */
1377 uint32 dsid
; /* implementation-specific diagnostic code */
1378 WERROR extended_err
; /* 0, STATUS code, or Windows error code */
1379 uint32 extended_data
; /* implementation-specific diagnostic code */
1380 uint16 problem
; /* 0 or PROBLEM error code */
1381 } drsuapi_DsAddEntryErrorInfoX
;
1384 * Ref: ATRERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.11 */
1387 WERROR extended_err
;
1388 uint32 extended_data
;
1390 drsuapi_DsAttributeId attid
;
1391 boolean32 is_val_returned
;
1392 drsuapi_DsAttributeValue attr_val
;
1393 } drsuapi_DsAddEntry_AttrErr_V1
;
1395 typedef [noprint
] struct {
1396 drsuapi_DsAddEntry_AttrErrListItem_V1
*next
;
1397 drsuapi_DsAddEntry_AttrErr_V1 err_data
;
1398 } drsuapi_DsAddEntry_AttrErrListItem_V1
;
1401 drsuapi_DsReplicaObjectIdentifier
*id;
1403 drsuapi_DsAddEntry_AttrErrListItem_V1 first
;
1404 } drsuapi_DsAddEntryErrorInfo_Attr_V1
;
1406 /* Name resolution error
1407 * Ref: NAMERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.14 */
1410 WERROR extended_err
;
1411 uint32 extended_data
;
1413 drsuapi_DsReplicaObjectIdentifier
*id_matched
; /* The best match for the supplied object identity */
1414 } drsuapi_DsAddEntryErrorInfo_Name_V1
;
1417 * Ref: REFERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.15 */
1419 [value
(83)] uint8 name_res
; /* Must be 'S' */
1420 [value
(0)] uint8 unused_pad
;
1421 [value
(0)] uint16 next_rdn
;
1422 } drsuapi_NameResOp_V1
;
1424 typedef [enum16bit
] enum {
1425 DRSUAPI_CH_REFTYPE_SUPERIOR
= 0x0000, /* referral to a superior DC */
1426 DRSUAPI_CH_REFTYPE_SUBORDINATE
= 0x0001, /* referral to a subordinate DC */
1427 DRSUAPI_CH_REFTYPE_NSSR
= 0x0002, /* Not used */
1428 DRSUAPI_CH_REFTYPE_CROSS
= 0x0003 /* A referral to an external crossRef object */
1429 } drsuapi_DsAddEntry_RefType
;
1431 typedef [enum8bit
] enum {
1432 DRSUAPI_SE_CHOICE_BASE_ONLY
= 0x00,
1433 DRSUAPI_SE_CHOICE_IMMED_CHLDRN
= 0x01,
1434 DRSUAPI_SE_CHOICE_WHOLE_SUBTREE
= 0x02
1435 } drsuapi_DsAddEntry_ChoiceType
;
1437 /* list of network names of the DCs
1438 * to which the referral is directed */
1440 drsuapi_DsaAddressListItem_V1
*next
;
1441 lsa_String
*address
;
1442 } drsuapi_DsaAddressListItem_V1
;
1445 drsuapi_DsReplicaObjectIdentifier
*id_target
; /* object to which the referral is directed */
1446 drsuapi_NameResOp_V1 op_state
;
1447 [value
(0)] uint16 rdn_alias
;
1448 [value
(0)] uint16 rdn_internal
;
1449 drsuapi_DsAddEntry_RefType ref_type
;
1450 uint16 addr_list_count
;
1451 drsuapi_DsaAddressListItem_V1
*addr_list
;
1452 drsuapi_DsAddEntry_RefErrListItem_V1
*next
;
1453 boolean32 is_choice_set
;
1454 drsuapi_DsAddEntry_ChoiceType choice
;
1455 } drsuapi_DsAddEntry_RefErrListItem_V1
;
1459 WERROR extended_err
;
1460 uint32 extended_data
;
1461 drsuapi_DsAddEntry_RefErrListItem_V1 refer
;
1462 } drsuapi_DsAddEntryErrorInfo_Referr_V1
;
1464 typedef [switch_type(uint32
)] union {
1465 [case(1)] drsuapi_DsAddEntryErrorInfo_Attr_V1 attr_err
;
1466 [case(2)] drsuapi_DsAddEntryErrorInfo_Name_V1 name_err
;
1467 [case(3)] drsuapi_DsAddEntryErrorInfo_Referr_V1 referral_err
;
1468 [case(4)] drsuapi_DsAddEntryErrorInfoX security_err
;
1469 [case(5)] drsuapi_DsAddEntryErrorInfoX service_err
;
1470 [case(6)] drsuapi_DsAddEntryErrorInfoX update_err
;
1471 [case(7)] drsuapi_DsAddEntryErrorInfoX system_err
;
1472 } drsuapi_DsAddEntryErrorInfo
;
1476 drsuapi_DsAddEntry_DirErr dir_err
;
1477 [switch_is(dir_err
)] drsuapi_DsAddEntryErrorInfo
*info
;
1478 } drsuapi_DsAddEntry_ErrData_V1
;
1480 typedef [switch_type(uint32
)] union {
1481 [case(1)] drsuapi_DsAddEntry_ErrData_V1 v1
;
1482 } drsuapi_DsAddEntry_ErrData
;
1487 } drsuapi_DsReplicaObjectIdentifier2
;
1490 drsuapi_DsReplicaObjectIdentifier
*id;
1491 drsuapi_DsAddEntry_DirErr dir_err
;
1492 uint32 dsid
; /* implementation-specific diagnostic code */
1493 WERROR extended_err
; /* 0, STATUS code, or Windows error code */
1494 uint32 extended_data
; /* implementation-specific diagnostic code */
1495 uint16 problem
; /* 0 or PROBLEM error code */
1496 [range(0,10000)] uint32 count
;
1497 [size_is(count
)] drsuapi_DsReplicaObjectIdentifier2
*objects
;
1498 } drsuapi_DsAddEntryCtr2
;
1501 drsuapi_DsReplicaObjectIdentifier
*id;
1502 uint32 err_ver
; /* Must be 1 */
1503 [switch_is(err_ver
)] drsuapi_DsAddEntry_ErrData
*err_data
;
1504 [range(0,10000)] uint32 count
;
1505 [size_is(count
)] drsuapi_DsReplicaObjectIdentifier2
*objects
;
1506 } drsuapi_DsAddEntryCtr3
;
1508 typedef [switch_type(uint32
)] union {
1509 [case(2)] drsuapi_DsAddEntryCtr2 ctr2
;
1510 [case(3)] drsuapi_DsAddEntryCtr3 ctr3
;
1511 } drsuapi_DsAddEntryCtr
;
1513 [public] WERROR drsuapi_DsAddEntry
(
1514 [in] policy_handle
*bind_handle
,
1516 [in,ref,switch_is(level
)] drsuapi_DsAddEntryRequest
*req
,
1517 [out,ref] uint32
*level_out
,
1518 [out,ref,switch_is(*level_out
)] drsuapi_DsAddEntryCtr
*ctr
1524 DRSUAPI_DS_EXECUTE_KCC_ASYNCHRONOUS_OPERATION
= 0x00000001,
1525 DRSUAPI_DS_EXECUTE_KCC_DAMPED
= 0x00000002
1526 } drsuapi_DsExecuteKCCFlags
;
1530 drsuapi_DsExecuteKCCFlags flags
;
1531 } drsuapi_DsExecuteKCC1
;
1533 typedef [switch_type(uint32
)] union {
1534 [case(1)] drsuapi_DsExecuteKCC1 ctr1
;
1535 } drsuapi_DsExecuteKCCRequest
;
1537 WERROR drsuapi_DsExecuteKCC
(
1538 [in] policy_handle
*bind_handle
,
1540 [in, ref, switch_is(level
)] drsuapi_DsExecuteKCCRequest
*req
1545 typedef [v1_enum] enum {
1546 DRSUAPI_DS_REPLICA_GET_INFO
= 1,
1547 DRSUAPI_DS_REPLICA_GET_INFO2
= 2
1548 } drsuapi_DsReplicaGetInfoLevel
;
1550 typedef [v1_enum] enum {
1551 DRSUAPI_DS_REPLICA_INFO_NEIGHBORS
= 0,
1552 DRSUAPI_DS_REPLICA_INFO_CURSORS
= 1,
1553 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA
= 2,
1554 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES
= 3,
1555 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES
= 4,
1556 DRSUAPI_DS_REPLICA_INFO_PENDING_OPS
= 5,
1557 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA
= 6,
1558 DRSUAPI_DS_REPLICA_INFO_CURSORS2
= 7,
1559 DRSUAPI_DS_REPLICA_INFO_CURSORS3
= 8,
1560 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2
= 9,
1561 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2
= 10,
1562 DRSUAPI_DS_REPLICA_INFO_REPSTO
= -2,
1563 DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS
= -4,
1564 DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1
= -5,
1565 DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS
= -6
1566 } drsuapi_DsReplicaInfoType
;
1569 drsuapi_DsReplicaInfoType info_type
;
1570 [charset
(UTF16
),string] uint16
*object_dn
;
1571 GUID source_dsa_guid
;
1572 } drsuapi_DsReplicaGetInfoRequest1
;
1575 drsuapi_DsReplicaInfoType info_type
;
1576 [charset
(UTF16
),string] uint16
*object_dn
;
1577 GUID source_dsa_guid
;
1579 [charset
(UTF16
),string] uint16
*attribute_name
;
1580 [charset
(UTF16
),string] uint16
*value_dn_str
;
1581 uint32 enumeration_context
;
1582 } drsuapi_DsReplicaGetInfoRequest2
;
1584 typedef [switch_type(drsuapi_DsReplicaGetInfoLevel
)] union {
1585 [case(DRSUAPI_DS_REPLICA_GET_INFO
)] drsuapi_DsReplicaGetInfoRequest1 req1
;
1586 [case(DRSUAPI_DS_REPLICA_GET_INFO2
)] drsuapi_DsReplicaGetInfoRequest2 req2
;
1587 } drsuapi_DsReplicaGetInfoRequest
;
1590 [charset
(UTF16
),string] uint16
*naming_context_dn
;
1591 [charset
(UTF16
),string] uint16
*source_dsa_obj_dn
;
1592 [charset
(UTF16
),string] uint16
*source_dsa_address
;
1593 [charset
(UTF16
),string] uint16
*transport_obj_dn
;
1594 drsuapi_DrsOptions replica_flags
;
1596 GUID naming_context_obj_guid
;
1597 GUID source_dsa_obj_guid
;
1598 GUID source_dsa_invocation_id
;
1599 GUID transport_obj_guid
;
1600 hyper tmp_highest_usn
;
1602 NTTIME last_success
;
1603 NTTIME last_attempt
;
1604 WERROR result_last_attempt
;
1605 uint32 consecutive_sync_failures
;
1606 } drsuapi_DsReplicaNeighbour
;
1611 [size_is(count
)] drsuapi_DsReplicaNeighbour array
[];
1612 } drsuapi_DsReplicaNeighbourCtr
;
1617 [size_is(count
)] drsuapi_DsReplicaCursor array
[];
1618 } drsuapi_DsReplicaCursorCtr
;
1621 [charset
(UTF16
),string] uint16
*attribute_name
;
1623 NTTIME originating_change_time
;
1624 GUID originating_invocation_id
;
1625 hyper originating_usn
;
1627 } drsuapi_DsReplicaObjMetaData
;
1632 [size_is(count
)] drsuapi_DsReplicaObjMetaData array
[];
1633 } drsuapi_DsReplicaObjMetaDataCtr
;
1636 [charset
(UTF16
),string] uint16
*dsa_obj_dn
;
1638 NTTIME first_failure
;
1639 uint32 num_failures
;
1641 } drsuapi_DsReplicaKccDsaFailure
;
1646 [size_is(count
)] drsuapi_DsReplicaKccDsaFailure array
[];
1647 } drsuapi_DsReplicaKccDsaFailuresCtr
;
1650 DRSUAPI_DS_REPLICA_OP_TYPE_SYNC
= 0,
1651 DRSUAPI_DS_REPLICA_OP_TYPE_ADD
= 1,
1652 DRSUAPI_DS_REPLICA_OP_TYPE_DELETE
= 2,
1653 DRSUAPI_DS_REPLICA_OP_TYPE_MODIFY
= 3,
1654 DRSUAPI_DS_REPLICA_OP_TYPE_UPDATE_REFS
= 4
1655 } drsuapi_DsReplicaOpType
;
1658 NTTIME operation_start
;
1659 uint32 serial_num
; /* unique till reboot */
1661 drsuapi_DsReplicaOpType operation_type
;
1662 drsuapi_DrsOptions options
;
1663 [charset
(UTF16
),string] uint16
*nc_dn
;
1664 [charset
(UTF16
),string] uint16
*remote_dsa_obj_dn
;
1665 [charset
(UTF16
),string] uint16
*remote_dsa_address
;
1667 GUID remote_dsa_obj_guid
;
1668 } drsuapi_DsReplicaOp
;
1673 [size_is(count
)] drsuapi_DsReplicaOp array
[];
1674 } drsuapi_DsReplicaOpCtr
;
1677 [charset
(UTF16
),string] uint16
*attribute_name
;
1678 [charset
(UTF16
),string] uint16
*object_dn
;
1679 [value
(ndr_size_DATA_BLOB
(0,binary
,0))] uint32 __ndr_size_binary
;
1684 NTTIME originating_change_time
;
1685 GUID originating_invocation_id
;
1686 hyper originating_usn
;
1688 } drsuapi_DsReplicaAttrValMetaData
;
1692 uint32 enumeration_context
;
1693 [size_is(count
)] drsuapi_DsReplicaAttrValMetaData array
[];
1694 } drsuapi_DsReplicaAttrValMetaDataCtr
;
1698 uint32 enumeration_context
;
1699 [size_is(count
)] drsuapi_DsReplicaCursor2 array
[];
1700 } drsuapi_DsReplicaCursor2Ctr
;
1703 GUID source_dsa_invocation_id
;
1705 NTTIME last_sync_success
;
1706 [charset
(UTF16
),string] uint16
*source_dsa_obj_dn
;
1707 } drsuapi_DsReplicaCursor3
;
1711 uint32 enumeration_context
;
1712 [size_is(count
)] drsuapi_DsReplicaCursor3 array
[];
1713 } drsuapi_DsReplicaCursor3Ctr
;
1716 [charset
(UTF16
),string] uint16
*attribute_name
;
1718 NTTIME originating_change_time
;
1719 GUID originating_invocation_id
;
1720 hyper originating_usn
;
1722 [charset
(UTF16
),string] uint16
*originating_dsa_dn
;
1723 } drsuapi_DsReplicaObjMetaData2
;
1727 uint32 enumeration_context
;
1728 [size_is(count
)] drsuapi_DsReplicaObjMetaData2 array
[];
1729 } drsuapi_DsReplicaObjMetaData2Ctr
;
1732 [charset
(UTF16
),string] uint16
*attribute_name
;
1733 [charset
(UTF16
),string] uint16
*object_dn
;
1734 [value
(ndr_size_DATA_BLOB
(0,binary
,0))] uint32 __ndr_size_binary
;
1739 NTTIME originating_change_time
;
1740 GUID originating_invocation_id
;
1741 hyper originating_usn
;
1743 [charset
(UTF16
),string] uint16
*originating_dsa_dn
;
1744 } drsuapi_DsReplicaAttrValMetaData2
;
1748 uint32 enumeration_context
;
1749 [size_is(count
)] drsuapi_DsReplicaAttrValMetaData2 array
[];
1750 } drsuapi_DsReplicaAttrValMetaData2Ctr
;
1753 hyper u1
; /* session number? */
1757 NTTIME_1sec bind_time
;
1758 [flag
(NDR_BIG_ENDIAN
)] ipv4address client_ip_address
;
1759 uint32 u5
; /* this is the same value the client used as pid in the DsBindInfoX struct */
1760 } drsuapi_DsReplicaConnection04
;
1763 [range(0,10000)] uint32 count
;
1765 [size_is(count
)] drsuapi_DsReplicaConnection04 array
[];
1766 } drsuapi_DsReplicaConnection04Ctr
;
1769 [charset
(UTF16
),string] uint16
*str1
;
1777 } drsuapi_DsReplica06
;
1780 [range(0,256)] uint32 count
;
1782 [size_is(count
)] drsuapi_DsReplica06 array
[];
1783 } drsuapi_DsReplica06Ctr
;
1785 typedef [switch_type(drsuapi_DsReplicaInfoType
)] union {
1786 [case(DRSUAPI_DS_REPLICA_INFO_NEIGHBORS
)] drsuapi_DsReplicaNeighbourCtr
*neighbours
;
1787 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS
)] drsuapi_DsReplicaCursorCtr
*cursors
;
1788 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA
)] drsuapi_DsReplicaObjMetaDataCtr
*objmetadata
;
1789 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES
)] drsuapi_DsReplicaKccDsaFailuresCtr
*connectfailures
;
1790 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES
)] drsuapi_DsReplicaKccDsaFailuresCtr
*linkfailures
;
1791 [case(DRSUAPI_DS_REPLICA_INFO_PENDING_OPS
)] drsuapi_DsReplicaOpCtr
*pendingops
;
1792 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA
)] drsuapi_DsReplicaAttrValMetaDataCtr
*attrvalmetadata
;
1793 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS2
)] drsuapi_DsReplicaCursor2Ctr
*cursors2
;
1794 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS3
)] drsuapi_DsReplicaCursor3Ctr
*cursors3
;
1795 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2
)] drsuapi_DsReplicaObjMetaData2Ctr
*objmetadata2
;
1796 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2
)] drsuapi_DsReplicaAttrValMetaData2Ctr
*attrvalmetadata2
;
1797 [case(DRSUAPI_DS_REPLICA_INFO_REPSTO
)] drsuapi_DsReplicaNeighbourCtr
*repsto
;
1798 [case(DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS
)] drsuapi_DsReplicaConnection04Ctr
*clientctx
;
1799 [case(DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1
)] drsuapi_DsReplicaCursorCtrEx
*udv1
;
1800 [case(DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS
)] drsuapi_DsReplica06Ctr
*srvoutgoingcalls
;
1801 } drsuapi_DsReplicaInfo
;
1803 WERROR drsuapi_DsReplicaGetInfo
(
1804 [in] policy_handle
*bind_handle
,
1805 [in] drsuapi_DsReplicaGetInfoLevel level
,
1806 [in,ref,switch_is(level
)] drsuapi_DsReplicaGetInfoRequest
*req
,
1807 [out,ref] drsuapi_DsReplicaInfoType
*info_type
,
1808 [out,ref,switch_is(*info_type
)] drsuapi_DsReplicaInfo
*info
1813 [todo
] WERROR DRSUAPI_ADD_SID_HISTORY
();
1819 [range(0,10000)] uint32 num_entries
;
1820 [size_is(num_entries
)] drsuapi_DsGetMembershipsCtr1
**ctrl_array
;
1821 } drsuapi_DsGetMemberships2Ctr1
;
1823 typedef [switch_type(uint32
)] union {
1824 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1
;
1825 } drsuapi_DsGetMemberships2Ctr
;
1828 [range(1,10000)] uint32 num_req
;
1829 [size_is(num_req
)] drsuapi_DsGetMembershipsRequest1
**req_array
;
1830 } drsuapi_DsGetMemberships2Request1
;
1832 typedef [switch_type(uint32
)] union {
1833 [case(1)] drsuapi_DsGetMemberships2Request1 req1
;
1834 } drsuapi_DsGetMemberships2Request
;
1836 WERROR drsuapi_DsGetMemberships2
(
1837 [in] policy_handle
*bind_handle
,
1839 [in,ref] [switch_is(level
)] drsuapi_DsGetMemberships2Request
*req
,
1840 [out,ref] uint32
*level_out
,
1841 [out,ref] [switch_is(*level_out
)] drsuapi_DsGetMemberships2Ctr
*ctr
1846 [todo
] WERROR DRSUAPI_REPLICA_VERIFY_OBJECTS
();
1850 [todo
] WERROR DRSUAPI_GET_OBJECT_EXISTENCE
();
1857 } drsuapi_DsSiteCostInfo
;
1860 [range(0,10000)] uint32 num_info
;
1861 [size_is(num_info
)] drsuapi_DsSiteCostInfo
*info
;
1862 [value
(0)] uint32 flags_reserved
;
1863 } drsuapi_QuerySitesByCostCtr1
;
1865 typedef [switch_type(uint32
)] union {
1866 [case(1)] drsuapi_QuerySitesByCostCtr1 ctr1
;
1867 } drsuapi_QuerySitesByCostCtr
;
1870 [charset
(UTF16
),string] uint16
*site_from
;
1871 [range(1,10000)] uint32 num_req
;
1872 [size_is(num_req
)] [charset
(UTF16
),string] uint16
**site_to
;
1874 } drsuapi_QuerySitesByCostRequest1
;
1876 typedef [switch_type(uint32
)] union {
1877 [case(1)] drsuapi_QuerySitesByCostRequest1 req1
;
1878 } drsuapi_QuerySitesByCostRequest
;
1880 WERROR drsuapi_QuerySitesByCost
(
1881 [in] policy_handle
*bind_handle
,
1883 [in,ref] [switch_is(level
)] drsuapi_QuerySitesByCostRequest
*req
,
1884 [out,ref] uint32
*level_out
,
1885 [out,ref] [switch_is(*level_out
)] drsuapi_QuerySitesByCostCtr
*ctr