s4:rootdse LDB module - remove unused variable
[Samba/gebeck_regimport.git] / librpc / idl / drsuapi.idl
blobbc21b229896fc8d287f440b49e91b09af686019e
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 /*****************/
62 /* Function 0x00 */
63 typedef [bitmap32bit] bitmap {
64 DRSUAPI_SUPPORTED_EXTENSION_BASE = 0x00000001,
65 DRSUAPI_SUPPORTED_EXTENSION_ASYNC_REPLICATION = 0x00000002,
66 DRSUAPI_SUPPORTED_EXTENSION_REMOVEAPI = 0x00000004,
67 DRSUAPI_SUPPORTED_EXTENSION_MOVEREQ_V2 = 0x00000008,
68 DRSUAPI_SUPPORTED_EXTENSION_GETCHG_COMPRESS = 0x00000010,
69 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V1 = 0x00000020,
70 DRSUAPI_SUPPORTED_EXTENSION_RESTORE_USN_OPTIMIZATION = 0x00000040,
71 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY = 0x00000080,
72 DRSUAPI_SUPPORTED_EXTENSION_KCC_EXECUTE = 0x00000100,
73 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY_V2 = 0x00000200,
74 DRSUAPI_SUPPORTED_EXTENSION_LINKED_VALUE_REPLICATION = 0x00000400,
75 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V2 = 0x00000800,
76 DRSUAPI_SUPPORTED_EXTENSION_INSTANCE_TYPE_NOT_REQ_ON_MOD= 0x00001000,
77 DRSUAPI_SUPPORTED_EXTENSION_CRYPTO_BIND = 0x00002000,
78 DRSUAPI_SUPPORTED_EXTENSION_GET_REPL_INFO = 0x00004000,
79 DRSUAPI_SUPPORTED_EXTENSION_STRONG_ENCRYPTION = 0x00008000,
80 DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V01 = 0x00010000,
81 DRSUAPI_SUPPORTED_EXTENSION_TRANSITIVE_MEMBERSHIP = 0x00020000,
82 DRSUAPI_SUPPORTED_EXTENSION_ADD_SID_HISTORY = 0x00040000,
83 DRSUAPI_SUPPORTED_EXTENSION_POST_BETA3 = 0x00080000,
84 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V5 = 0x00100000,
85 DRSUAPI_SUPPORTED_EXTENSION_GET_MEMBERSHIPS2 = 0x00200000,
86 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V6 = 0x00400000,
87 DRSUAPI_SUPPORTED_EXTENSION_NONDOMAIN_NCS = 0x00800000,
88 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V8 = 0x01000000,
89 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V5 = 0x02000000,
90 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V6 = 0x04000000,
92 * the following 3 have the same value
93 * repadmin.exe /bind says that
95 DRSUAPI_SUPPORTED_EXTENSION_ADDENTRYREPLY_V3 = 0x08000000,
96 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V7 = 0x08000000,
97 DRSUAPI_SUPPORTED_EXTENSION_VERIFY_OBJECT = 0x08000000,
98 DRSUAPI_SUPPORTED_EXTENSION_XPRESS_COMPRESS = 0x10000000,
99 DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V10 = 0x20000000,
100 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART2 = 0x40000000,
101 DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART3 = 0x80000000
102 } drsuapi_SupportedExtensions;
104 typedef [bitmap32bit] bitmap {
105 DRSUAPI_SUPPORTED_EXTENSION_ADAM = 0x00000001,
106 DRSUAPI_SUPPORTED_EXTENSION_LH_BETA2 = 0x00000002,
107 DRSUAPI_SUPPORTED_EXTENSION_RECYCLE_BIN = 0x00000004
108 } drsuapi_SupportedExtensionsExt;
110 /* this is used by w2k */
111 typedef struct {
112 drsuapi_SupportedExtensions supported_extensions;
113 GUID site_guid;
114 uint32 pid;
115 } drsuapi_DsBindInfo24;
117 /* this is used by w2k3 */
118 typedef struct {
119 drsuapi_SupportedExtensions supported_extensions;
120 GUID site_guid;
121 uint32 pid;
122 uint32 repl_epoch;
123 } drsuapi_DsBindInfo28;
125 /* this is used by w2k8 */
126 typedef struct {
127 drsuapi_SupportedExtensions supported_extensions;
128 GUID site_guid;
129 uint32 pid;
130 uint32 repl_epoch;
131 drsuapi_SupportedExtensionsExt supported_extensions_ext;
132 GUID config_dn_guid;
133 } drsuapi_DsBindInfo48;
135 typedef struct {
136 [flag(NDR_REMAINING)] DATA_BLOB info;
137 } drsuapi_DsBindInfoFallBack;
139 typedef [nodiscriminant] union {
140 [case(24)][subcontext(4)] drsuapi_DsBindInfo24 info24;
141 [case(28)][subcontext(4)] drsuapi_DsBindInfo28 info28;
142 [case(48)][subcontext(4)] drsuapi_DsBindInfo48 info48;
143 [default][subcontext(4)] drsuapi_DsBindInfoFallBack FallBack;
144 } drsuapi_DsBindInfo;
146 /* the drsuapi_DsBindInfoCtr was this before
147 * typedef [flag(NDR_PAHEX)] struct {
148 * [range(1,10000)] uint32 length;
149 * [size_is(length)] uint8 data[];
150 * } drsuapi_DsBindInfo;
152 * but we don't want the caller to manually decode this blob,
153 * so we're doing it here
156 typedef struct {
157 [range(1,10000)] uint32 length;
158 [switch_is(length)] drsuapi_DsBindInfo info;
159 } drsuapi_DsBindInfoCtr;
161 /* this is a magic guid you need to pass to DsBind to make drsuapi_DsWriteAccountSpn() work
163 * maybe the bind_guid could also be the invocation_id see drsuapi_DsReplicaConnection04
165 const char *DRSUAPI_DS_BIND_GUID = "e24d201a-4fd6-11d1-a3da-0000f875ae0d";
167 * this magic guid are needed to fetch the whole tree with drsuapi_DsGetNCChanges()
168 * as administrator and this values are also used in the destination_dsa_guid field
169 * of drsuapi_DsGetNCChangesReq5/8 and the source_dsa_guid is zero.
171 const char *DRSUAPI_DS_BIND_GUID_W2K = "6abec3d1-3054-41c8-a362-5a0c5b7d5d71";
172 const char *DRSUAPI_DS_BIND_GUID_W2K3 = "6afab99c-6e26-464a-975f-f58f105218bc";
174 [public] WERROR drsuapi_DsBind(
175 [in,unique] GUID *bind_guid,
176 [in,out,unique] drsuapi_DsBindInfoCtr *bind_info,
177 [out] policy_handle *bind_handle
180 /*****************/
181 /* Function 0x01 */
182 WERROR drsuapi_DsUnbind(
183 [in,out] policy_handle *bind_handle
186 /*****************/
187 /* Function 0x02 */
188 typedef [public,gensize] struct {
189 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier(r, ndr->flags)-4)] uint32 __ndr_size;
190 [value(ndr_size_dom_sid28(&sid, ndr->flags))] uint32 __ndr_size_sid;
191 GUID guid;
192 dom_sid28 sid;
193 [value(strlen_m(dn))] uint32 __ndr_size_dn;
194 [charset(UTF16),size_is(__ndr_size_dn+1)] uint16 dn[];
195 } drsuapi_DsReplicaObjectIdentifier;
197 typedef struct {
198 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
199 GUID source_dsa_guid;
200 astring *source_dsa_dns; /* Source DSA dns_name in <guid>._msdcs.<domain_dns> form */
201 drsuapi_DrsOptions options;
202 } drsuapi_DsReplicaSyncRequest1;
204 typedef [switch_type(uint32)] union {
205 [case(1)] drsuapi_DsReplicaSyncRequest1 req1;
206 } drsuapi_DsReplicaSyncRequest;
208 WERROR drsuapi_DsReplicaSync(
209 [in] policy_handle *bind_handle,
210 [in] uint32 level,
211 [in,switch_is(level)] drsuapi_DsReplicaSyncRequest *req
214 /*****************/
215 /* Function 0x03 */
216 typedef [public] struct {
217 hyper tmp_highest_usn; /* updated after each object update */
218 hyper reserved_usn;
219 hyper highest_usn; /* updated after a full replication cycle */
220 } drsuapi_DsReplicaHighWaterMark;
222 typedef [public] struct {
223 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
224 hyper highest_usn; /* updated after a full replication cycle */
225 } drsuapi_DsReplicaCursor;
227 typedef struct {
228 [value(1)] uint32 version;
229 [value(0)] uint32 reserved1;
230 [range(0,0x100000)] uint32 count;
231 [value(0)] uint32 reserved2;
232 [size_is(count)] drsuapi_DsReplicaCursor cursors[];
233 } drsuapi_DsReplicaCursorCtrEx;
235 typedef [flag(NDR_PAHEX),v1_enum] enum {
236 DRSUAPI_EXOP_NONE = 0x00000000,
237 DRSUAPI_EXOP_FSMO_REQ_ROLE = 0x00000001,
238 DRSUAPI_EXOP_FSMO_RID_ALLOC = 0x00000002,
239 DRSUAPI_EXOP_FSMO_RID_REQ_ROLE = 0x00000003,
240 DRSUAPI_EXOP_FSMO_REQ_PDC = 0x00000004,
241 DRSUAPI_EXOP_FSMO_ABANDON_ROLE = 0x00000005,
242 DRSUAPI_EXOP_REPL_OBJ = 0x00000006,
243 DRSUAPI_EXOP_REPL_SECRET = 0x00000007
244 } drsuapi_DsExtendedOperation;
246 typedef [flag(NDR_PAHEX),v1_enum] enum {
247 DRSUAPI_EXOP_ERR_NONE = 0x00000000,
248 DRSUAPI_EXOP_ERR_SUCCESS = 0x00000001,
249 DRSUAPI_EXOP_ERR_UNKNOWN_OP = 0x00000002,
250 DRSUAPI_EXOP_ERR_FSMO_NOT_OWNER = 0x00000003,
251 DRSUAPI_EXOP_ERR_UPDATE_ERR = 0x00000004,
252 DRSUAPI_EXOP_ERR_EXCEPTION = 0x00000005,
253 DRSUAPI_EXOP_ERR_UNKNOWN_CALLER = 0x00000006,
254 DRSUAPI_EXOP_ERR_RID_ALLOC = 0x00000007,
255 DRSUAPI_EXOP_ERR_FSMO_OWNER_DELETED = 0x00000008,
256 DRSUAPI_EXOP_ERR_FMSO_PENDING_OP = 0x00000009,
257 DRSUAPI_EXOP_ERR_MISMATCH = 0x0000000A,
258 DRSUAPI_EXOP_ERR_COULDNT_CONTACT = 0x0000000B,
259 DRSUAPI_EXOP_ERR_FSMO_REFUSING_ROLES = 0x0000000C,
260 DRSUAPI_EXOP_ERR_DIR_ERROR = 0x0000000D,
261 DRSUAPI_EXOP_ERR_FSMO_MISSING_SETTINGS = 0x0000000E,
262 DRSUAPI_EXOP_ERR_ACCESS_DENIED = 0x0000000F,
263 DRSUAPI_EXOP_ERR_PARAM_ERROR = 0x00000010
264 } drsuapi_DsExtendedError;
266 typedef struct {
267 GUID destination_dsa_guid;
268 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
269 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
270 drsuapi_DsReplicaHighWaterMark highwatermark;
271 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
272 drsuapi_DrsOptions replica_flags;
273 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
274 uint32 max_ndr_size; /* w2k3 seems to ignore this */
275 drsuapi_DsExtendedOperation extended_op;
276 hyper fsmo_info;
277 } drsuapi_DsGetNCChangesRequest5;
280 * In DRSUAPI all attributes with syntax 2.5.5.2
281 * are identified by uint32 values
283 * the following table shows the mapping used between the two representations
284 * e.g. - objectClass 'nTDSDSA' has governsID: 1.2.840.113556.1.5.7000.47
285 * and a UINT32-ID of '0x0017002F'.
286 * - so the OID 1.2.840.113556.1.5.7000.47 is splitted into a
287 * OID-prefix: 1.2.840.113556.1.5.7000
288 * and a value: 47 => 0x2F
289 * - the mapping table gives a UINT32-prefix: 0x00170000
290 * - and the UINT32-ID is 0x0017002F = 0x00170000 | 0x2F
292 * This prefix mapping table is replied in the drsuapi_DsReplicaOIDMapping_Ctr
293 * array. The following are the default mappings of w2k3
295 * OID-prefix => UINT32-Id prefix
297 * 2.5.4.* => 0x00000000 (standard attributes RFC2256 core.schema)
298 * 2.5.6.* => 0x00010000 (standard object classes RFC2256 core.schema)
299 * 1.2.840.113556.1.2.* => 0x00020000
300 * 1.2.840.113556.1.3.* => 0x00030000
301 * 2.5.5.* => 0x00080000 (attributeSyntax OID's)
302 * 1.2.840.113556.1.4.* => 0x00090000
303 * 1.2.840.113556.1.5.* => 0x000A0000
304 * 2.16.840.1.113730.3.* => 0x00140000
305 * 0.9.2342.19200300.100.1.* => 0x00150000
306 * 2.16.840.1.113730.3.1.* => 0x00160000
307 * 1.2.840.113556.1.5.7000.* => 0x00170000
308 * 2.5.21.* => 0x00180000 (attrs for SubSchema)
309 * 2.5.18.* => 0x00190000 (createTimeStamp,modifyTimeStamp, SubSchema)
310 * 2.5.20.* => 0x001A0000
311 * 1.3.6.1.4.1.1466.101.119.* => 0x001B0000 (dynamicObject, entryTTL)
312 * 2.16.840.1.113730.3.2.* => 0x001C0000
313 * 1.3.6.1.4.1.250.1.* => 0x001D0000
314 * 1.2.840.113549.1.9.* => 0x001E0000 (unstructuredAddress,unstructuredName)
315 * 0.9.2342.19200300.100.4.* => 0x001F0000
317 * Here's a list of used 'attributeSyntax' OID's
319 * 2.5.5.1 => Object(DS-DN) string
320 * struct drsuapi_DsObjectIdentifier3
322 * 2.5.5.2 => OID-string
323 * => all values are represented as uint32 values in drsuapi
324 * => governsID, attributeID and attributeSyntax returned as OID-Strings in LDAP
325 * => mayContain, mustContain and all other attributes with 2.5.5.2 syntax
326 * are returned as attribute names
328 * 2.5.5.4 => String(Teletex) case-insensitive string with teletex charset
330 * 2.5.5.5 => String(IA5) case-sensitive string
332 * 2.5.5.6 => String(Numeric)
333 * => eg. internationalISDNNumber
335 * 2.5.5.7 => Object(DN-Binary) B:<byte count>:<bytes>:<object DN>
336 * => e.g. wellKnownObjects
338 * 2.5.5.8 => BOOL
340 * 2.5.5.9 => int32
342 * 2.5.5.10 => DATA_BLOB
343 * => struct GUID
345 * 2.5.5.11 => LDAP timestring
346 * => NTTIME_1sec
348 * 2.5.5.12 => String(Unicode) case-insensitive string
349 * => 'standard strings'
351 * 2.5.5.13 => Object(Presentation-Address) string
352 * => used in objectClass applicationEntity
354 * 2.5.5.14 => Object(DN-String) S:<char count>:<string>:<object DN>
355 * => not used
357 * 2.5.5.15 => ntSecurityDescriptor
359 * 2.5.5.16 => int64
361 * 2.5.5.17 => dom_sid
363 typedef [noprint] struct {
364 [range(0,10000)] uint32 length;
365 [size_is(length)] uint8 *binary_oid; /* partial-binary-OID encoded with asn1_write_partial_OID_String() */
366 } drsuapi_DsReplicaOID;
368 typedef struct {
369 uint32 id_prefix;
370 drsuapi_DsReplicaOID oid;
371 } drsuapi_DsReplicaOIDMapping;
373 typedef [public] struct {
374 [range(0,0x100000)] uint32 num_mappings;
375 [size_is(num_mappings)] drsuapi_DsReplicaOIDMapping *mappings;
376 } drsuapi_DsReplicaOIDMapping_Ctr;
378 typedef [flag(NDR_PAHEX),v1_enum] enum {
379 DRSUAPI_OBJECTCLASS_top = 0x00010000,
380 DRSUAPI_OBJECTCLASS_classSchema = 0x0003000d,
381 DRSUAPI_OBJECTCLASS_attributeSchema = 0x0003000e
382 } drsuapi_DsObjectClassId;
384 typedef [flag(NDR_PAHEX),v1_enum,public] enum {
385 DRSUAPI_ATTID_objectClass = 0x00000000,
386 DRSUAPI_ATTID_cn = 0x00000003,
387 DRSUAPI_ATTID_ou = 0x0000000b,
388 DRSUAPI_ATTID_description = 0x0000000d,
389 DRSUAPI_ATTID_member = 0x0000001f,
390 DRSUAPI_ATTID_instanceType = 0x00020001,
391 DRSUAPI_ATTID_whenCreated = 0x00020002,
392 DRSUAPI_ATTID_possSuperiors = 0x00020008,
393 DRSUAPI_ATTID_displayName = 0x0002000d,
394 DRSUAPI_ATTID_hasMasterNCs = 0x0002000e,
395 DRSUAPI_ATTID_subClassOf = 0x00020015,
396 DRSUAPI_ATTID_governsID = 0x00020016,
397 DRSUAPI_ATTID_mustContain = 0x00020018,
398 DRSUAPI_ATTID_mayContain = 0x00020019,
399 DRSUAPI_ATTID_rDNAttId = 0x0002001A,
400 DRSUAPI_ATTID_attributeID = 0x0002001e,
401 DRSUAPI_ATTID_attributeSyntax = 0x00020020,
402 DRSUAPI_ATTID_isSingleValued = 0x00020021,
403 DRSUAPI_ATTID_rangeLower = 0x00020022,
404 DRSUAPI_ATTID_rangeUpper = 0x00020023,
405 DRSUAPI_ATTID_dMDLocation = 0x00020024,
406 DRSUAPI_ATTID_isDeleted = 0x00020030,
407 DRSUAPI_ATTID_objectVersion = 0x0002004c,
408 DRSUAPI_ATTID_invocationId = 0x00020073,
409 DRSUAPI_ATTID_showInAdvancedViewOnly = 0x000200a9,
410 DRSUAPI_ATTID_adminDisplayName = 0x000200c2,
411 DRSUAPI_ATTID_adminDescription = 0x000200e2,
412 DRSUAPI_ATTID_oMSyntax = 0x000200e7,
413 DRSUAPI_ATTID_ntSecurityDescriptor = 0x00020119,
414 DRSUAPI_ATTID_searchFlags = 0x0002014e,
415 DRSUAPI_ATTID_auxiliaryClass = 0x0002015f,
416 DRSUAPI_ATTID_lDAPDisplayName = 0x000201cc,
417 DRSUAPI_ATTID_name = 0x00090001,
418 DRSUAPI_ATTID_userAccountControl = 0x00090008,
419 DRSUAPI_ATTID_codePage = 0x00090010,
420 DRSUAPI_ATTID_countryCode = 0x00090019,
421 DRSUAPI_ATTID_currentValue = 0x0009001b,
422 DRSUAPI_ATTID_homeDirectory = 0x0009002c,
423 DRSUAPI_ATTID_homeDrive = 0x0009002d,
424 DRSUAPI_ATTID_dBCSPwd = 0x00090037,/* lmPwdHash */
425 DRSUAPI_ATTID_scriptPath = 0x0009003e,
426 DRSUAPI_ATTID_logonHours = 0x00090040,
427 DRSUAPI_ATTID_userWorkstations = 0x00090056,
428 DRSUAPI_ATTID_unicodePwd = 0x0009005a,/* ntPwdHash */
429 DRSUAPI_ATTID_ntPwdHistory = 0x0009005e,
430 DRSUAPI_ATTID_pwdLastSet = 0x00090060,
431 DRSUAPI_ATTID_primaryGroupID = 0x00090062,
432 DRSUAPI_ATTID_priorValue = 0x00090064,
433 DRSUAPI_ATTID_supplementalCredentials = 0x0009007d,
434 DRSUAPI_ATTID_trustAuthIncoming = 0x00090081,
435 DRSUAPI_ATTID_trustAuthOutgoing = 0x00090087,
436 DRSUAPI_ATTID_profilePath = 0x0009008b,
437 DRSUAPI_ATTID_objectSid = 0x00090092,
438 DRSUAPI_ATTID_schemaIDGUID = 0x00090094,
439 DRSUAPI_ATTID_comment = 0x0009009C,/* User-Comment */
440 DRSUAPI_ATTID_accountExpires = 0x0009009f,
441 DRSUAPI_ATTID_lmPwdHistory = 0x000900a0,
442 DRSUAPI_ATTID_systemPossSuperiors = 0x000900c3,
443 DRSUAPI_ATTID_systemMayContain = 0x000900c4,
444 DRSUAPI_ATTID_systemMustContain = 0x000900c5,
445 DRSUAPI_ATTID_systemAuxiliaryClass = 0x000900c6,
446 DRSUAPI_ATTID_sAMAccountName = 0x000900dd,
447 DRSUAPI_ATTID_sAMAccountType = 0x0009012e,
448 DRSUAPI_ATTID_options = 0x00090133,
449 DRSUAPI_ATTID_fSMORoleOwner = 0x00090171,
450 DRSUAPI_ATTID_systemFlags = 0x00090177,
451 DRSUAPI_ATTID_serverReference = 0x00090203,
452 DRSUAPI_ATTID_serverReferenceBL = 0x00090204,
453 DRSUAPI_ATTID_initialAuthIncoming = 0x0009021b,
454 DRSUAPI_ATTID_initialAuthOutgoing = 0x0009021c,
455 DRSUAPI_ATTID_wellKnownObjects = 0x0009026a,
456 DRSUAPI_ATTID_dNSHostName = 0x0009026b,
457 DRSUAPI_ATTID_isMemberOfPartialAttributeSet = 0x0009027f,
458 DRSUAPI_ATTID_userPrincipalName = 0x00090290,
459 DRSUAPI_ATTID_groupType = 0x000902ee,
460 DRSUAPI_ATTID_servicePrincipalName = 0x00090303,
461 DRSUAPI_ATTID_lastKnownParent = 0x0009030d,
462 DRSUAPI_ATTID_objectCategory = 0x0009030e,
463 DRSUAPI_ATTID_gPLink = 0x0009037b,
464 DRSUAPI_ATTID_transportAddressAttribute = 0x0009037f,
465 DRSUAPI_ATTID_msDS_Behavior_Version = 0x000905b3,
466 DRSUAPI_ATTID_msDS_KeyVersionNumber = 0x000906f6,
467 DRSUAPI_ATTID_msDS_HasDomainNCs = 0x0009071c,
468 DRSUAPI_ATTID_msDS_hasMasterNCs = 0x0009072c,
469 DRSUAPI_ATTID_isRecycled = 0x0009080a,
471 DRSUAPI_ATTID_INVALID = 0xFFFFFFFF
472 } drsuapi_DsAttributeId;
474 typedef struct {
475 [value(1)] uint32 version;
476 [value(0)] uint32 reserved1;
477 [range(1,0x100000)] uint32 num_attids;
478 [size_is(num_attids)] drsuapi_DsAttributeId attids[];
479 } drsuapi_DsPartialAttributeSet;
481 typedef struct {
482 GUID destination_dsa_guid;
483 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
484 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
485 drsuapi_DsReplicaHighWaterMark highwatermark;
486 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
487 drsuapi_DrsOptions replica_flags;
488 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
489 uint32 max_ndr_size; /* w2k3 seems to ignore this */
490 drsuapi_DsExtendedOperation extended_op;
491 hyper fsmo_info;
492 drsuapi_DsPartialAttributeSet *partial_attribute_set;
493 drsuapi_DsPartialAttributeSet *partial_attribute_set_ex;
494 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
495 } drsuapi_DsGetNCChangesRequest8;
497 typedef struct {
498 GUID destination_dsa_guid;
499 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
500 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
501 drsuapi_DsReplicaHighWaterMark highwatermark;
502 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
503 drsuapi_DrsOptions replica_flags;
504 uint32 max_object_count; /* w2k3 uses min(133,max(100,max_object_count)) */
505 uint32 max_ndr_size; /* w2k3 seems to ignore this */
506 drsuapi_DsExtendedOperation extended_op;
507 hyper fsmo_info;
508 drsuapi_DsPartialAttributeSet *partial_attribute_set;
509 drsuapi_DsPartialAttributeSet *partial_attribute_set_ex;
510 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
511 uint32 more_flags;
512 } drsuapi_DsGetNCChangesRequest10;
514 typedef [switch_type(uint32)] union {
515 [case(5)] drsuapi_DsGetNCChangesRequest5 req5;
516 [case(8)] drsuapi_DsGetNCChangesRequest8 req8;
517 [case(10)] drsuapi_DsGetNCChangesRequest10 req10;
518 } drsuapi_DsGetNCChangesRequest;
520 typedef [public] struct {
521 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
522 hyper highest_usn; /* updated after a full replication cycle */
523 NTTIME last_sync_success;
524 } drsuapi_DsReplicaCursor2;
526 typedef struct {
527 [value(2)] uint32 version;
528 [value(0)] uint32 reserved1;
529 [range(0,0x100000)] uint32 count;
530 [value(0)] uint32 reserved2;
531 [size_is(count)] drsuapi_DsReplicaCursor2 cursors[];
532 } drsuapi_DsReplicaCursor2CtrEx;
534 /* Generic DATA_BLOB values */
535 typedef struct {
536 [range(0,10485760),value(ndr_size_DATA_BLOB(0,blob,0))] uint32 __ndr_size;
537 DATA_BLOB *blob;
538 } drsuapi_DsAttributeValue;
540 typedef struct {
541 [range(0,10485760)] uint32 num_values;
542 [size_is(num_values)] drsuapi_DsAttributeValue *values;
543 } drsuapi_DsAttributeValueCtr;
545 /* DN String values */
546 typedef [public,gensize] struct {
547 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier3(r, ndr->flags))] uint32 __ndr_size;
548 [value(ndr_size_dom_sid28(&sid,ndr->flags))] uint32 __ndr_size_sid;
549 GUID guid;
550 dom_sid28 sid;
551 [value(strlen_m(dn))] uint32 __ndr_size_dn;
552 [charset(UTF16)] uint16 dn[__ndr_size_dn+1];
553 } drsuapi_DsReplicaObjectIdentifier3;
555 typedef [public] struct {
556 [value(ndr_size_drsuapi_DsReplicaObjectIdentifier3Binary_without_Binary(r, ndr->flags))] uint32 __ndr_size;
557 [value(ndr_size_dom_sid28(&sid,ndr->flags))] uint32 __ndr_size_sid;
558 GUID guid;
559 dom_sid28 sid;
560 [value(strlen_m(dn))] uint32 __ndr_size_dn;
561 [charset(UTF16)] uint16 dn[__ndr_size_dn+1];
562 [value(binary.length + 4)] uint32 __ndr_size_binary;
563 [flag(NDR_REMAINING)] DATA_BLOB binary;
564 } drsuapi_DsReplicaObjectIdentifier3Binary;
566 typedef [public,noprint] struct {
567 drsuapi_DsAttributeId attid;
568 drsuapi_DsAttributeValueCtr value_ctr;
569 } drsuapi_DsReplicaAttribute;
571 typedef struct {
572 [range(0,1048576)] uint32 num_attributes;
573 [size_is(num_attributes)] drsuapi_DsReplicaAttribute *attributes;
574 } drsuapi_DsReplicaAttributeCtr;
576 typedef [public] bitmap {
577 DRSUAPI_DS_REPLICA_OBJECT_FROM_MASTER = 0x00000001,
578 DRSUAPI_DS_REPLICA_OBJECT_DYNAMIC = 0x00000002,
579 DRSUAPI_DS_REPLICA_OBJECT_REMOTE_MODIFY = 0x00010000
580 } drsuapi_DsReplicaObjectFlags;
582 typedef [public] struct {
583 drsuapi_DsReplicaObjectIdentifier *identifier;
584 drsuapi_DsReplicaObjectFlags flags;
585 drsuapi_DsReplicaAttributeCtr attribute_ctr;
586 } drsuapi_DsReplicaObject;
588 typedef struct {
589 uint32 version;
590 NTTIME_1sec originating_change_time;
591 GUID originating_invocation_id;
592 hyper originating_usn;
593 } drsuapi_DsReplicaMetaData;
595 typedef [public] struct {
596 [range(0,1048576)] uint32 count;
597 [size_is(count)] drsuapi_DsReplicaMetaData meta_data[];
598 } drsuapi_DsReplicaMetaDataCtr;
600 typedef [public,noprint] struct {
601 drsuapi_DsReplicaObjectListItemEx *next_object;
602 drsuapi_DsReplicaObject object;
603 boolean32 is_nc_prefix;
604 GUID *parent_object_guid;
605 drsuapi_DsReplicaMetaDataCtr *meta_data_ctr;
606 } drsuapi_DsReplicaObjectListItemEx;
608 typedef [public,gensize] struct {
609 GUID source_dsa_guid; /* the 'objectGUID' field of the CN=NTDS Settings object */
610 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
611 drsuapi_DsReplicaObjectIdentifier *naming_context;
612 drsuapi_DsReplicaHighWaterMark old_highwatermark;
613 drsuapi_DsReplicaHighWaterMark new_highwatermark;
614 drsuapi_DsReplicaCursorCtrEx *uptodateness_vector;
615 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
616 drsuapi_DsExtendedError extended_ret; /* w2k sends the nc_object_count value here */
617 uint32 object_count;
618 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
619 [value(ndr_size_drsuapi_DsGetNCChangesCtr1(r,ndr->flags)+55)] uint32 __ndr_size;
620 drsuapi_DsReplicaObjectListItemEx *first_object;
621 boolean32 more_data;
622 } drsuapi_DsGetNCChangesCtr1;
625 * if the DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE flag
626 * isn't there it means the value is deleted
628 typedef [public] bitmap {
629 DRSUAPI_DS_LINKED_ATTRIBUTE_FLAG_ACTIVE = 0x00000001
630 } drsuapi_DsLinkedAttributeFlags;
632 typedef [public] struct {
633 drsuapi_DsReplicaObjectIdentifier *identifier;
634 drsuapi_DsAttributeId attid;
635 drsuapi_DsAttributeValue value;
636 drsuapi_DsLinkedAttributeFlags flags;
637 NTTIME_1sec originating_add_time;
638 drsuapi_DsReplicaMetaData meta_data;
639 } drsuapi_DsReplicaLinkedAttribute;
641 /* [MS-DRSR] section 4.1.10.2.11 DRS_MSG_GETCHGREPLY_V6 */
642 typedef [public,gensize] struct {
643 GUID source_dsa_guid; /* the 'objectGUID' field of the CN=NTDS Settings object */
644 GUID source_dsa_invocation_id; /* the 'invocationId' field of the CN=NTDS Settings object */
645 drsuapi_DsReplicaObjectIdentifier *naming_context;
646 drsuapi_DsReplicaHighWaterMark old_highwatermark;
647 drsuapi_DsReplicaHighWaterMark new_highwatermark;
648 drsuapi_DsReplicaCursor2CtrEx *uptodateness_vector;
649 drsuapi_DsReplicaOIDMapping_Ctr mapping_ctr;
650 drsuapi_DsExtendedError extended_ret;
651 uint32 object_count;
652 /* this +55 is sometimes +56, so I don't know where this comes from... --metze */
653 [value(ndr_size_drsuapi_DsGetNCChangesCtr6(r,ndr->flags)+55)] uint32 __ndr_size;
654 drsuapi_DsReplicaObjectListItemEx *first_object;
655 boolean32 more_data;
656 uint32 nc_object_count; /* estimated amount of objects in the whole NC */
657 uint32 nc_linked_attributes_count; /* estimated amount of linked values in the whole NC */
658 [range(0,1048576)] uint32 linked_attributes_count;
659 [size_is(linked_attributes_count)] drsuapi_DsReplicaLinkedAttribute *linked_attributes;
660 WERROR drs_error;
661 } drsuapi_DsGetNCChangesCtr6;
663 typedef [public] struct {
664 [subcontext(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr1 ctr1;
665 } drsuapi_DsGetNCChangesCtr1TS;
667 typedef [public] struct {
668 [subcontext(0xFFFFFC01)] drsuapi_DsGetNCChangesCtr6 ctr6;
669 } drsuapi_DsGetNCChangesCtr6TS;
671 typedef [nopush] struct {
672 uint32 decompressed_length;
673 uint32 compressed_length;
674 [subcontext(4),subcontext_size(compressed_length),
675 compression(NDR_COMPRESSION_MSZIP,compressed_length,decompressed_length)]
676 drsuapi_DsGetNCChangesCtr1TS *ts;
677 } drsuapi_DsGetNCChangesMSZIPCtr1;
679 typedef [nopush] struct {
680 uint32 decompressed_length;
681 uint32 compressed_length;
682 [subcontext(4),subcontext_size(compressed_length),
683 compression(NDR_COMPRESSION_MSZIP,compressed_length,decompressed_length)]
684 drsuapi_DsGetNCChangesCtr6TS *ts;
685 } drsuapi_DsGetNCChangesMSZIPCtr6;
687 typedef [nopush] struct {
688 uint32 decompressed_length;
689 uint32 compressed_length;
690 [subcontext(4),subcontext_size(compressed_length),
691 compression(NDR_COMPRESSION_XPRESS,compressed_length,decompressed_length)]
692 drsuapi_DsGetNCChangesCtr1TS *ts;
693 } drsuapi_DsGetNCChangesXPRESSCtr1;
695 typedef [nopush] struct {
696 uint32 decompressed_length;
697 uint32 compressed_length;
698 [subcontext(4),subcontext_size(compressed_length),
699 compression(NDR_COMPRESSION_XPRESS,compressed_length,decompressed_length)]
700 drsuapi_DsGetNCChangesCtr6TS *ts;
701 } drsuapi_DsGetNCChangesXPRESSCtr6;
703 typedef [enum16bit] enum {
704 DRSUAPI_COMPRESSION_TYPE_MSZIP = 2,
705 DRSUAPI_COMPRESSION_TYPE_XPRESS = 3
706 } drsuapi_DsGetNCChangesCompressionType;
708 typedef [nodiscriminant,flag(NDR_PAHEX)] union {
709 [case(1|(DRSUAPI_COMPRESSION_TYPE_MSZIP<<16))] drsuapi_DsGetNCChangesMSZIPCtr1 mszip1;
710 [case(6|(DRSUAPI_COMPRESSION_TYPE_MSZIP<<16))] drsuapi_DsGetNCChangesMSZIPCtr6 mszip6;
711 [case(1|(DRSUAPI_COMPRESSION_TYPE_XPRESS<<16))] drsuapi_DsGetNCChangesXPRESSCtr1 xpress1;
712 [case(6|(DRSUAPI_COMPRESSION_TYPE_XPRESS<<16))] drsuapi_DsGetNCChangesXPRESSCtr6 xpress6;
713 } drsuapi_DsGetNCChangesCompressedCtr;
715 typedef struct {
716 drsuapi_DsGetNCChangesMSZIPCtr1 mszip1;
717 } drsuapi_DsGetNCChangesCtr2;
719 typedef struct {
720 [range(0,6)] uint32 level;
721 [range(2,3)] drsuapi_DsGetNCChangesCompressionType type;
722 [switch_is(level | (type<<16))] drsuapi_DsGetNCChangesCompressedCtr ctr;
723 } drsuapi_DsGetNCChangesCtr7;
725 typedef [switch_type(uint32)] union {
726 [case(1)] drsuapi_DsGetNCChangesCtr1 ctr1;
727 [case(2)] drsuapi_DsGetNCChangesCtr2 ctr2;
728 [case(6)] drsuapi_DsGetNCChangesCtr6 ctr6;
729 [case(7)] drsuapi_DsGetNCChangesCtr7 ctr7;
730 } drsuapi_DsGetNCChangesCtr;
732 WERROR drsuapi_DsGetNCChanges(
733 [in] policy_handle *bind_handle,
734 [in] uint32 level,
735 [in,ref,switch_is(level)] drsuapi_DsGetNCChangesRequest *req,
736 [out,ref] uint32 *level_out,
737 [out,ref,switch_is(*level_out)] drsuapi_DsGetNCChangesCtr *ctr
740 /*****************/
741 /* Function 0x04 */
742 /* [MS-DRSR] 4.1.26 */
744 typedef struct {
745 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
746 [ref,charset(DOS),string] uint8 *dest_dsa_dns_name;
747 GUID dest_dsa_guid;
748 drsuapi_DrsOptions options;
749 } drsuapi_DsReplicaUpdateRefsRequest1;
751 typedef [switch_type(uint32)] union {
752 [case(1)] drsuapi_DsReplicaUpdateRefsRequest1 req1;
753 } drsuapi_DsReplicaUpdateRefsRequest;
755 WERROR drsuapi_DsReplicaUpdateRefs(
756 [in] policy_handle *bind_handle,
757 [in] uint32 level,
758 [in,switch_is(level)] drsuapi_DsReplicaUpdateRefsRequest req
761 /*****************/
762 /* Function 0x05 */
764 typedef struct {
765 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
766 [charset(UTF16),string] uint16 *source_dsa_address;
767 uint8 schedule[84];
768 drsuapi_DrsOptions options;
769 } drsuapi_DsReplicaAddRequest1;
771 typedef struct {
772 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
773 drsuapi_DsReplicaObjectIdentifier *source_dsa_dn;
774 drsuapi_DsReplicaObjectIdentifier *transport_dn;
775 [charset(UTF16),string] uint16 *source_dsa_address;
776 uint8 schedule[84];
777 drsuapi_DrsOptions options;
778 } drsuapi_DsReplicaAddRequest2;
780 typedef [switch_type(uint32)] union {
781 [case(1)] drsuapi_DsReplicaAddRequest1 req1;
782 [case(2)] drsuapi_DsReplicaAddRequest2 req2;
783 } drsuapi_DsReplicaAddRequest;
785 WERROR drsuapi_DsReplicaAdd(
786 [in] policy_handle *bind_handle,
787 [in] uint32 level,
788 [in,switch_is(level)] drsuapi_DsReplicaAddRequest req
792 /*****************/
793 /* Function 0x06 */
794 typedef struct {
795 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
796 [charset(UTF16),string] uint16 *source_dsa_address;
797 drsuapi_DrsOptions options;
798 } drsuapi_DsReplicaDelRequest1;
800 typedef [switch_type(uint32)] union {
801 [case(1)] drsuapi_DsReplicaDelRequest1 req1;
802 } drsuapi_DsReplicaDelRequest;
804 WERROR drsuapi_DsReplicaDel(
805 [in] policy_handle *bind_handle,
806 [in] uint32 level,
807 [in,switch_is(level)] drsuapi_DsReplicaDelRequest req
810 /*****************/
811 /* Function 0x07 */
813 typedef struct {
814 [ref] drsuapi_DsReplicaObjectIdentifier *naming_context;
815 GUID source_dra;
816 [charset(UTF16),string] uint16 *source_dra_address;
817 uint8 schedule[84];
818 drsuapi_DrsOptions replica_flags;
819 uint32 modify_fields;
820 drsuapi_DrsOptions options;
821 } drsuapi_DsReplicaModRequest1;
823 typedef [switch_type(uint32)] union {
824 [case(1)] drsuapi_DsReplicaModRequest1 req1;
825 } drsuapi_DsReplicaModRequest;
827 WERROR drsuapi_DsReplicaMod(
828 [in] policy_handle *bind_handle,
829 [in] uint32 level,
830 [in,switch_is(level)] drsuapi_DsReplicaModRequest req
833 /*****************/
834 /* Function 0x08 */
835 [todo] WERROR DRSUAPI_VERIFY_NAMES();
837 /*****************/
838 /* Function 0x09 */
840 /* how are type 4 and 7 different from 2 and 3 ? */
841 typedef [v1_enum] enum {
842 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_AND_DOMAIN_GROUPS = 1,
843 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS = 2,
844 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS = 3,
845 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_LOCAL_GROUPS2 = 4,
846 DRSUAPI_DS_MEMBERSHIP_TYPE_UNIVERSAL_GROUPS = 5,
847 DRSUAPI_DS_MEMBERSHIP_TYPE_GROUPMEMBERS = 6,
848 DRSUAPI_DS_MEMBERSHIP_TYPE_DOMAIN_GROUPS2 = 7
849 } drsuapi_DsMembershipType;
851 typedef struct {
852 NTSTATUS status;
853 [range(0,10000)] uint32 num_memberships;
854 [range(0,10000)] uint32 num_sids;
855 [size_is(num_memberships)] drsuapi_DsReplicaObjectIdentifier **info_array;
856 [size_is(num_memberships)] samr_GroupAttrs *group_attrs;
857 [size_is(num_sids)] dom_sid28 **sids;
858 } drsuapi_DsGetMembershipsCtr1;
860 typedef [switch_type(uint32)] union {
861 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1;
862 } drsuapi_DsGetMembershipsCtr;
864 const int DRSUAPI_DS_MEMBERSHIP_FLAG_GROUP_ATTR = 0x1;
866 typedef struct {
867 [range(1,10000)] uint32 count;
868 [size_is(count)] drsuapi_DsReplicaObjectIdentifier **info_array;
869 uint32 flags;
870 [range(1,7)] drsuapi_DsMembershipType type;
871 drsuapi_DsReplicaObjectIdentifier *domain;
872 } drsuapi_DsGetMembershipsRequest1;
874 typedef [switch_type(uint32)] union {
875 [case(1)] drsuapi_DsGetMembershipsRequest1 req1;
876 } drsuapi_DsGetMembershipsRequest;
878 WERROR drsuapi_DsGetMemberships(
879 [in] policy_handle *bind_handle,
880 [in] uint32 level,
881 [in,ref] [switch_is(level)] drsuapi_DsGetMembershipsRequest *req,
882 [out,ref] uint32 *level_out,
883 [out,ref] [switch_is(*level_out)] drsuapi_DsGetMembershipsCtr *ctr
886 /*****************/
887 /* Function 0x0a */
888 [todo] WERROR DRSUAPI_INTER_DOMAIN_MOVE();
890 /*****************/
891 /* Function 0x0b */
892 typedef [bitmap32bit] bitmap {
893 DRSUAPI_NT4_CHANGELOG_GET_CHANGELOG = 0x00000001,
894 DRSUAPI_NT4_CHANGELOG_GET_SERIAL_NUMBERS = 0x00000002
895 } drsuapi_DsGetNT4ChangeLogFlags;
897 typedef struct {
898 drsuapi_DsGetNT4ChangeLogFlags flags;
899 uint32 preferred_maximum_length;
900 [range(0,0x00A00000)] uint32 restart_length;
901 [size_is(restart_length)] uint8 *restart_data;
902 } drsuapi_DsGetNT4ChangeLogRequest1;
904 typedef [switch_type(uint32)] union {
905 [case(1)] drsuapi_DsGetNT4ChangeLogRequest1 req1;
906 } drsuapi_DsGetNT4ChangeLogRequest;
908 typedef struct {
909 [range(0,0x00A00000)] uint32 restart_length;
910 [range(0,0x00A00000)] uint32 log_length;
911 hyper sam_serial_number;
912 NTTIME sam_creation_time;
913 hyper builtin_serial_number;
914 NTTIME builtin_creation_time;
915 hyper lsa_serial_number;
916 NTTIME lsa_creation_time;
917 NTSTATUS status;
918 [size_is(restart_length)] uint8 *restart_data;
919 [size_is(log_length)] uint8 *log_data;
920 } drsuapi_DsGetNT4ChangeLogInfo1;
922 typedef [switch_type(uint32)] union {
923 [case(1)] drsuapi_DsGetNT4ChangeLogInfo1 info1;
924 } drsuapi_DsGetNT4ChangeLogInfo;
926 WERROR drsuapi_DsGetNT4ChangeLog(
927 [in] policy_handle *bind_handle,
928 [in] uint32 level,
929 [in,ref] [switch_is(level)] drsuapi_DsGetNT4ChangeLogRequest *req,
930 [out,ref] uint32 *level_out,
931 [out,ref] [switch_is(*level_out)] drsuapi_DsGetNT4ChangeLogInfo *info
934 /*****************/
935 /* Function 0x0c */
936 typedef [v1_enum] enum {
937 DRSUAPI_DS_NAME_STATUS_OK = 0,
938 DRSUAPI_DS_NAME_STATUS_RESOLVE_ERROR = 1,
939 DRSUAPI_DS_NAME_STATUS_NOT_FOUND = 2,
940 DRSUAPI_DS_NAME_STATUS_NOT_UNIQUE = 3,
941 DRSUAPI_DS_NAME_STATUS_NO_MAPPING = 4,
942 DRSUAPI_DS_NAME_STATUS_DOMAIN_ONLY = 5,
943 DRSUAPI_DS_NAME_STATUS_NO_SYNTACTICAL_MAPPING = 6,
944 DRSUAPI_DS_NAME_STATUS_TRUST_REFERRAL = 7
945 } drsuapi_DsNameStatus;
947 typedef [v1_enum] enum {
948 DRSUAPI_DS_NAME_FLAG_NO_FLAGS = 0x0,
949 DRSUAPI_DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1,
950 DRSUAPI_DS_NAME_FLAG_EVAL_AT_DC = 0x2,
951 DRSUAPI_DS_NAME_FLAG_GCVERIFY = 0x4,
952 DRSUAPI_DS_NAME_FLAG_TRUST_REFERRAL = 0x8
953 } drsuapi_DsNameFlags;
955 typedef [v1_enum] enum {
956 DRSUAPI_DS_NAME_FORMAT_UNKNOWN = 0x00000000,
957 DRSUAPI_DS_NAME_FORMAT_FQDN_1779 = 0x00000001,
958 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT = 0x00000002,
959 DRSUAPI_DS_NAME_FORMAT_DISPLAY = 0x00000003,
960 DRSUAPI_DS_NAME_FORMAT_GUID = 0x00000006,
961 DRSUAPI_DS_NAME_FORMAT_CANONICAL = 0x00000007,
962 DRSUAPI_DS_NAME_FORMAT_USER_PRINCIPAL = 0x00000008,
963 DRSUAPI_DS_NAME_FORMAT_CANONICAL_EX = 0x00000009,
964 DRSUAPI_DS_NAME_FORMAT_SERVICE_PRINCIPAL = 0x0000000A,
965 DRSUAPI_DS_NAME_FORMAT_SID_OR_SID_HISTORY = 0x0000000B,
966 DRSUAPI_DS_NAME_FORMAT_DNS_DOMAIN = 0x0000000C,
967 DRSUAPI_DS_NAME_FORMAT_UPN_AND_ALTSECID = 0xFFFFFFEF,
968 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN_EX = 0xFFFFFFF0,
969 DRSUAPI_DS_NAME_FORMAT_LIST_GLOBAL_CATALOG_SERVERS = 0xFFFFFFF1,
970 DRSUAPI_DS_NAME_FORMAT_UPN_FOR_LOGON = 0xFFFFFFF2,
971 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_WITH_DCS_IN_SITE = 0xFFFFFFF3,
972 DRSUAPI_DS_NAME_FORMAT_STRING_SID_NAME = 0xFFFFFFF4,
973 DRSUAPI_DS_NAME_FORMAT_ALT_SECURITY_IDENTITIES_NAME = 0xFFFFFFF5,
974 DRSUAPI_DS_NAME_FORMAT_LIST_NCS = 0xFFFFFFF6,
975 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS = 0xFFFFFFF7,
976 DRSUAPI_DS_NAME_FORMAT_MAP_SCHEMA_GUID = 0xFFFFFFF8,
977 DRSUAPI_DS_NAME_FORMAT_NT4_ACCOUNT_NAME_SANS_DOMAIN = 0xFFFFFFF9,
978 DRSUAPI_DS_NAME_FORMAT_LIST_ROLES = 0xFFFFFFFA,
979 DRSUAPI_DS_NAME_FORMAT_LIST_INFO_FOR_SERVER = 0xFFFFFFFB,
980 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_FOR_DOMAIN_IN_SITE = 0xFFFFFFFC,
981 DRSUAPI_DS_NAME_FORMAT_LIST_DOMAINS_IN_SITE = 0xFFFFFFFD,
982 DRSUAPI_DS_NAME_FORMAT_LIST_SERVERS_IN_SITE = 0xFFFFFFFE,
983 DRSUAPI_DS_NAME_FORMAT_LIST_SITES = 0xFFFFFFFF
984 } drsuapi_DsNameFormat;
986 typedef struct {
987 [string,charset(UTF16)] uint16 *str;
988 } drsuapi_DsNameString;
990 typedef struct {
991 uint32 codepage; /* 0x000004e4 - 1252 is german codepage*/
992 uint32 language; /* 0x00000407 - german language ID*/
993 drsuapi_DsNameFlags format_flags;
994 drsuapi_DsNameFormat format_offered;
995 drsuapi_DsNameFormat format_desired;
996 [range(1,10000)] uint32 count;
997 [size_is(count)] drsuapi_DsNameString *names;
998 } drsuapi_DsNameRequest1;
1000 typedef [switch_type(uint32)] union {
1001 [case(1)] drsuapi_DsNameRequest1 req1;
1002 } drsuapi_DsNameRequest;
1004 typedef struct {
1005 drsuapi_DsNameStatus status;
1006 [charset(UTF16),string] uint16 *dns_domain_name;
1007 [charset(UTF16),string] uint16 *result_name;
1008 } drsuapi_DsNameInfo1;
1010 typedef struct {
1011 uint32 count;
1012 [size_is(count)] drsuapi_DsNameInfo1 *array;
1013 } drsuapi_DsNameCtr1;
1015 typedef [switch_type(uint32)] union {
1016 [case(1)] drsuapi_DsNameCtr1 *ctr1;
1017 } drsuapi_DsNameCtr;
1019 WERROR drsuapi_DsCrackNames(
1020 [in] policy_handle *bind_handle,
1021 [in] uint32 level,
1022 [in,ref,switch_is(level)] drsuapi_DsNameRequest *req,
1023 [out,ref] uint32 *level_out,
1024 [out,ref,switch_is(*level_out)] drsuapi_DsNameCtr *ctr
1027 /*****************/
1028 /* Function 0x0d */
1029 typedef [v1_enum] enum {
1030 DRSUAPI_DS_SPN_OPERATION_ADD = 0,
1031 DRSUAPI_DS_SPN_OPERATION_REPLACE= 1,
1032 DRSUAPI_DS_SPN_OPERATION_DELETE = 2
1033 } drsuapi_DsSpnOperation;
1035 typedef struct {
1036 drsuapi_DsSpnOperation operation;
1037 uint32 unknown1;
1038 [charset(UTF16),string] uint16 *object_dn;
1039 [range(0,10000)] uint32 count;
1040 [size_is(count)] drsuapi_DsNameString *spn_names;
1041 } drsuapi_DsWriteAccountSpnRequest1;
1043 typedef [switch_type(uint32)] union {
1044 [case(1)] drsuapi_DsWriteAccountSpnRequest1 req1;
1045 } drsuapi_DsWriteAccountSpnRequest;
1047 typedef struct {
1048 WERROR status;
1049 } drsuapi_DsWriteAccountSpnResult1;
1051 typedef [switch_type(uint32)] union {
1052 [case(1)] drsuapi_DsWriteAccountSpnResult1 res1;
1053 } drsuapi_DsWriteAccountSpnResult;
1055 WERROR drsuapi_DsWriteAccountSpn(
1056 [in] policy_handle *bind_handle,
1057 [in] uint32 level,
1058 [in,ref,switch_is(level)] drsuapi_DsWriteAccountSpnRequest *req,
1059 [out,ref] uint32 *level_out,
1060 [out,ref,switch_is(*level_out)] drsuapi_DsWriteAccountSpnResult *res
1063 /*****************/
1064 /* Function 0x0e */
1065 typedef struct {
1066 [charset(UTF16),string] uint16 *server_dn;
1067 [charset(UTF16),string] uint16 *domain_dn;
1068 boolean32 commit;
1069 } drsuapi_DsRemoveDSServerRequest1;
1071 typedef [switch_type(uint32)] union {
1072 [case(1)] drsuapi_DsRemoveDSServerRequest1 req1;
1073 } drsuapi_DsRemoveDSServerRequest;
1075 typedef struct {
1076 boolean32 last_dc_in_domain;
1077 } drsuapi_DsRemoveDSServerResult1;
1079 typedef [switch_type(uint32)] union {
1080 [case(1)] drsuapi_DsRemoveDSServerResult1 res1;
1081 } drsuapi_DsRemoveDSServerResult;
1083 WERROR drsuapi_DsRemoveDSServer(
1084 [in] policy_handle *bind_handle,
1085 [in] uint32 level,
1086 [in,ref,switch_is(level)] drsuapi_DsRemoveDSServerRequest *req,
1087 [out,ref] uint32 *level_out,
1088 [out,ref,switch_is(*level_out)] drsuapi_DsRemoveDSServerResult *res
1091 /*****************/
1092 /* Function 0x0f */
1093 [todo] WERROR DRSUAPI_REMOVE_DS_DOMAIN();
1095 /*****************/
1096 /* Function 0x10 */
1097 typedef struct {
1098 [charset(UTF16),string] uint16 *domain_name; /* netbios or dns */
1099 int32 level; /* specifies the switch level for the request */
1100 } drsuapi_DsGetDCInfoRequest1;
1102 typedef [switch_type(int32)] union {
1103 [case(1)] drsuapi_DsGetDCInfoRequest1 req1;
1104 } drsuapi_DsGetDCInfoRequest;
1106 typedef struct {
1107 [charset(UTF16),string] uint16 *netbios_name;
1108 [charset(UTF16),string] uint16 *dns_name;
1109 [charset(UTF16),string] uint16 *site_name;
1110 [charset(UTF16),string] uint16 *computer_dn;
1111 [charset(UTF16),string] uint16 *server_dn;
1112 uint32 is_pdc;
1113 uint32 is_enabled;
1114 } drsuapi_DsGetDCInfo1;
1116 typedef struct {
1117 [range(0,10000)] uint32 count;
1118 [size_is(count)] drsuapi_DsGetDCInfo1 *array;
1119 } drsuapi_DsGetDCInfoCtr1;
1121 typedef struct {
1122 [charset(UTF16),string] uint16 *netbios_name;
1123 [charset(UTF16),string] uint16 *dns_name;
1124 [charset(UTF16),string] uint16 *site_name;
1125 [charset(UTF16),string] uint16 *site_dn;
1126 [charset(UTF16),string] uint16 *computer_dn;
1127 [charset(UTF16),string] uint16 *server_dn;
1128 [charset(UTF16),string] uint16 *ntds_dn;
1129 uint32 is_pdc;
1130 uint32 is_enabled;
1131 uint32 is_gc;
1132 GUID site_guid;
1133 GUID computer_guid;
1134 GUID server_guid;
1135 GUID ntds_guid;
1136 } drsuapi_DsGetDCInfo2;
1138 typedef struct {
1139 [range(0,10000)] uint32 count;
1140 [size_is(count)] drsuapi_DsGetDCInfo2 *array;
1141 } drsuapi_DsGetDCInfoCtr2;
1143 typedef struct {
1144 [charset(UTF16),string] uint16 *netbios_name;
1145 [charset(UTF16),string] uint16 *dns_name;
1146 [charset(UTF16),string] uint16 *site_name;
1147 [charset(UTF16),string] uint16 *site_dn;
1148 [charset(UTF16),string] uint16 *computer_dn;
1149 [charset(UTF16),string] uint16 *server_dn;
1150 [charset(UTF16),string] uint16 *ntds_dn;
1151 uint32 is_pdc;
1152 uint32 is_enabled;
1153 uint32 is_gc;
1154 uint32 is_rodc;
1155 GUID site_guid;
1156 GUID computer_guid;
1157 GUID server_guid;
1158 GUID ntds_guid;
1159 } drsuapi_DsGetDCInfo3;
1161 typedef struct {
1162 [range(0,10000)] uint32 count;
1163 [size_is(count)] drsuapi_DsGetDCInfo3 *array;
1164 } drsuapi_DsGetDCInfoCtr3;
1167 * this represents an active connection to the
1168 * Directory System Agent (DSA)
1169 * this can be via LDAP or DRSUAPI
1171 typedef struct {
1172 [flag(NDR_BIG_ENDIAN)] ipv4address client_ip_address;
1173 uint32 unknown2;
1174 uint32 connection_time; /* in seconds */
1175 uint32 unknown4;
1176 uint32 unknown5;
1177 uint32 unknown6;
1179 * client_account can be the following:
1180 * "W2K3\Administrator"
1181 * "Administrator@W2K3"
1182 * "cn=Administrator,cn=Users,DC=w2k3,DC=vmnet1,DC=vm,DC=base"
1183 * ""
1184 * or NULL
1186 [charset(UTF16),string] uint16 *client_account;
1187 } drsuapi_DsGetDCConnection01;
1189 typedef struct {
1190 [range(0,10000)] uint32 count;
1191 [size_is(count)] drsuapi_DsGetDCConnection01 *array;
1192 } drsuapi_DsGetDCConnectionCtr01;
1194 typedef [v1_enum] enum {
1195 DRSUAPI_DC_INFO_CTR_1 = 1,
1196 DRSUAPI_DC_INFO_CTR_2 = 2,
1197 DRSUAPI_DC_INFO_CTR_3 = 3,
1198 DRSUAPI_DC_CONNECTION_CTR_01 = -1
1199 } drsuapi_DsGetDCInfoCtrLevels;
1201 typedef [switch_type(int32)] union {
1202 [case(DRSUAPI_DC_INFO_CTR_1)] drsuapi_DsGetDCInfoCtr1 ctr1;
1203 [case(DRSUAPI_DC_INFO_CTR_2)] drsuapi_DsGetDCInfoCtr2 ctr2;
1204 [case(DRSUAPI_DC_INFO_CTR_3)] drsuapi_DsGetDCInfoCtr3 ctr3;
1205 [case(DRSUAPI_DC_CONNECTION_CTR_01)] drsuapi_DsGetDCConnectionCtr01 ctr01;
1206 } drsuapi_DsGetDCInfoCtr;
1208 WERROR drsuapi_DsGetDomainControllerInfo(
1209 [in] policy_handle *bind_handle,
1210 [in] int32 level,
1211 [in,ref,switch_is(level)] drsuapi_DsGetDCInfoRequest *req,
1212 [out,ref] int32 *level_out,
1213 [out,ref,switch_is(*level_out)] drsuapi_DsGetDCInfoCtr *ctr
1216 /*****************/
1217 /* Function 0x11 */
1218 typedef [public,noprint] struct {
1219 drsuapi_DsReplicaObjectListItem *next_object;
1220 drsuapi_DsReplicaObject object;
1221 } drsuapi_DsReplicaObjectListItem;
1224 * The DsAddEntry() call which creates a nTDSDSA object,
1225 * also adds a servicePrincipalName in the following form
1226 * to the computer account of the new domain controller
1227 * referenced by the "serverReferenece" attribute.
1229 * E3514235-4B06-11D1-AB04-00C04FC2DCD2/<new-ntdsdsa-object-guid-as-string>/<domain-dns-name>
1231 * also note that the "serverReference" isn't added to the new object!
1233 const char *DRSUAPI_NTDSDSA_KRB5_SERVICE_GUID = "E3514235-4B06-11D1-AB04-00C04FC2DCD2";
1235 /* Error codes to classify an error that occurs
1236 * during a search for, or the update of,
1237 * a directory object */
1238 typedef [v1_enum] enum {
1239 DRSUAPI_DIRERR_OK = 0,
1240 DRSUAPI_DIRERR_ATTRIBUTE = 1,
1241 DRSUAPI_DIRERR_NAME = 2,
1242 DRSUAPI_DIRERR_REFERRAL = 3,
1243 DRSUAPI_DIRERR_SECURITY = 4,
1244 DRSUAPI_DIRERR_SERVICE = 5,
1245 DRSUAPI_DIRERR_UPDATE = 6,
1246 DRSUAPI_DIRERR_SYSTEM = 7
1247 } drsuapi_DsAddEntry_DirErr;
1250 * Ref: DRS_MSG_ADDENTRYREQ_V2, [MS-DRSR]: 4.1.1.1.3
1252 typedef struct {
1253 drsuapi_DsReplicaObjectListItem first_object;
1254 } drsuapi_DsAddEntryRequest2;
1256 /* Buffer type is actually more
1257 * like a semi Flags
1258 * Ref: DRS_SecBuffer, [MS-DRSR]: 5.41 */
1259 typedef [v1_enum,noprint] enum {
1260 DRSUAPI_SECBUFFER_EMPTY = 0x00000000,
1261 DRSUAPI_SECBUFFER_DATA = 0x00000001,
1262 DRSUAPI_SECBUFFER_TOKEN = 0x00000002,
1263 DRSUAPI_SECBUFFER_PKG_PARAMS = 0x00000003,
1264 DRSUAPI_SECBUFFER_MISSING = 0x00000004,
1265 DRSUAPI_SECBUFFER_EXTRA = 0x00000005,
1266 DRSUAPI_SECBUFFER_STREAM_TRAILER = 0x00000006,
1267 DRSUAPI_SECBUFFER_STREAM_HEADER = 0x00000007,
1268 DRSUAPI_SECBUFFER_READONLY = 0x80000000
1269 } drsuapi_SecBufferType;
1271 typedef struct {
1272 [range(0,10000)] uint32 buf_size;
1273 drsuapi_SecBufferType buf_type;
1274 [size_is(buf_size)] uint8 *buffer;
1275 } drsuapi_SecBuffer;
1277 typedef struct {
1278 [value(0)] uint32 version;
1279 [range(0,10000)] uint32 buff_count;
1280 [size_is(buff_count)] drsuapi_SecBuffer *buffers;
1281 } drsuapi_SecBufferDesc;
1284 * Ref: DRS_MSG_ADDENTRYREQ_V3, [MS-DRSR]: 4.1.1.1.4
1286 typedef struct {
1287 drsuapi_DsReplicaObjectListItem first_object;
1288 drsuapi_SecBufferDesc *client_creds;
1289 } drsuapi_DsAddEntryRequest3;
1291 typedef [switch_type(uint32)] union {
1292 [case(2)] drsuapi_DsAddEntryRequest2 req2;
1293 [case(3)] drsuapi_DsAddEntryRequest3 req3;
1294 } drsuapi_DsAddEntryRequest;
1296 /* Generic extended error info
1297 * commonly used in most places
1298 * where rich error info is returned */
1299 typedef struct {
1300 uint32 dsid; /* implementation-specific diagnostic code */
1301 WERROR extended_err; /* 0, STATUS code, or Windows error code */
1302 uint32 extended_data; /* implementation-specific diagnostic code */
1303 uint16 problem; /* 0 or PROBLEM error code */
1304 } drsuapi_DsAddEntryErrorInfoX;
1306 /* Attribute errors
1307 * Ref: ATRERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.11 */
1308 typedef struct {
1309 uint32 dsid;
1310 WERROR extended_err;
1311 uint32 extended_data;
1312 uint16 problem;
1313 drsuapi_DsAttributeId attid;
1314 boolean32 is_val_returned;
1315 drsuapi_DsAttributeValue attr_val;
1316 } drsuapi_DsAddEntry_AttrErr_V1;
1318 typedef [noprint] struct {
1319 drsuapi_DsAddEntry_AttrErrListItem_V1 *next;
1320 drsuapi_DsAddEntry_AttrErr_V1 err_data;
1321 } drsuapi_DsAddEntry_AttrErrListItem_V1;
1323 typedef struct {
1324 drsuapi_DsReplicaObjectIdentifier *id;
1325 uint32 count;
1326 drsuapi_DsAddEntry_AttrErrListItem_V1 first;
1327 } drsuapi_DsAddEntryErrorInfo_Attr_V1;
1329 /* Name resolution error
1330 * Ref: NAMERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.14 */
1331 typedef struct {
1332 uint32 dsid;
1333 WERROR extended_err;
1334 uint32 extended_data;
1335 uint16 problem;
1336 drsuapi_DsReplicaObjectIdentifier *id_matched; /* The best match for the supplied object identity */
1337 } drsuapi_DsAddEntryErrorInfo_Name_V1;
1339 /* Referral error
1340 * Ref: REFERR_DRS_WIRE_V1, [MS-DRSR]: 4.1.1.1.15 */
1341 typedef struct {
1342 [value(83)] uint8 name_res; /* Must be 'S' */
1343 [value(0)] uint8 unused_pad;
1344 [value(0)] uint16 next_rdn;
1345 } drsuapi_NameResOp_V1;
1347 typedef [enum16bit] enum {
1348 DRSUAPI_CH_REFTYPE_SUPERIOR = 0x0000, /* referral to a superior DC */
1349 DRSUAPI_CH_REFTYPE_SUBORDINATE = 0x0001, /* referral to a subordinate DC */
1350 DRSUAPI_CH_REFTYPE_NSSR = 0x0002, /* Not used */
1351 DRSUAPI_CH_REFTYPE_CROSS = 0x0003 /* A referral to an external crossRef object */
1352 } drsuapi_DsAddEntry_RefType;
1354 typedef [enum8bit] enum {
1355 DRSUAPI_SE_CHOICE_BASE_ONLY = 0x00,
1356 DRSUAPI_SE_CHOICE_IMMED_CHLDRN = 0x01,
1357 DRSUAPI_SE_CHOICE_WHOLE_SUBTREE = 0x02
1358 } drsuapi_DsAddEntry_ChoiceType;
1360 /* list of network names of the DCs
1361 * to which the referral is directed */
1362 typedef struct {
1363 drsuapi_DsaAddressListItem_V1 *next;
1364 lsa_String *address;
1365 } drsuapi_DsaAddressListItem_V1;
1367 typedef struct {
1368 drsuapi_DsReplicaObjectIdentifier *id_target; /* object to which the referral is directed */
1369 drsuapi_NameResOp_V1 op_state;
1370 [value(0)] uint16 rdn_alias;
1371 [value(0)] uint16 rdn_internal;
1372 drsuapi_DsAddEntry_RefType ref_type;
1373 uint16 addr_list_count;
1374 drsuapi_DsaAddressListItem_V1 *addr_list;
1375 drsuapi_DsAddEntry_RefErrListItem_V1 *next;
1376 boolean32 is_choice_set;
1377 drsuapi_DsAddEntry_ChoiceType choice;
1378 } drsuapi_DsAddEntry_RefErrListItem_V1;
1380 typedef struct {
1381 uint32 dsid;
1382 WERROR extended_err;
1383 uint32 extended_data;
1384 drsuapi_DsAddEntry_RefErrListItem_V1 refer;
1385 } drsuapi_DsAddEntryErrorInfo_Referr_V1;
1387 typedef [switch_type(uint32)] union {
1388 [case(1)] drsuapi_DsAddEntryErrorInfo_Attr_V1 attr_err;
1389 [case(2)] drsuapi_DsAddEntryErrorInfo_Name_V1 name_err;
1390 [case(3)] drsuapi_DsAddEntryErrorInfo_Referr_V1 referral_err;
1391 [case(4)] drsuapi_DsAddEntryErrorInfoX security_err;
1392 [case(5)] drsuapi_DsAddEntryErrorInfoX service_err;
1393 [case(6)] drsuapi_DsAddEntryErrorInfoX update_err;
1394 [case(7)] drsuapi_DsAddEntryErrorInfoX system_err;
1395 } drsuapi_DsAddEntryErrorInfo;
1397 typedef struct {
1398 WERROR status;
1399 drsuapi_DsAddEntry_DirErr dir_err;
1400 [switch_is(dir_err)] drsuapi_DsAddEntryErrorInfo *info;
1401 } drsuapi_DsAddEntry_ErrData_V1;
1403 typedef [switch_type(uint32)] union {
1404 [case(1)] drsuapi_DsAddEntry_ErrData_V1 v1;
1405 } drsuapi_DsAddEntry_ErrData;
1407 typedef struct {
1408 GUID guid;
1409 dom_sid28 sid;
1410 } drsuapi_DsReplicaObjectIdentifier2;
1412 typedef struct {
1413 drsuapi_DsReplicaObjectIdentifier *id;
1414 drsuapi_DsAddEntry_DirErr dir_err;
1415 uint32 dsid; /* implementation-specific diagnostic code */
1416 WERROR extended_err; /* 0, STATUS code, or Windows error code */
1417 uint32 extended_data; /* implementation-specific diagnostic code */
1418 uint16 problem; /* 0 or PROBLEM error code */
1419 [range(0,10000)] uint32 count;
1420 [size_is(count)] drsuapi_DsReplicaObjectIdentifier2 *objects;
1421 } drsuapi_DsAddEntryCtr2;
1423 typedef struct {
1424 drsuapi_DsReplicaObjectIdentifier *id;
1425 uint32 err_ver; /* Must be 1 */
1426 [switch_is(err_ver)] drsuapi_DsAddEntry_ErrData *err_data;
1427 [range(0,10000)] uint32 count;
1428 [size_is(count)] drsuapi_DsReplicaObjectIdentifier2 *objects;
1429 } drsuapi_DsAddEntryCtr3;
1431 typedef [switch_type(uint32)] union {
1432 [case(2)] drsuapi_DsAddEntryCtr2 ctr2;
1433 [case(3)] drsuapi_DsAddEntryCtr3 ctr3;
1434 } drsuapi_DsAddEntryCtr;
1436 [public] WERROR drsuapi_DsAddEntry(
1437 [in] policy_handle *bind_handle,
1438 [in] uint32 level,
1439 [in,ref,switch_is(level)] drsuapi_DsAddEntryRequest *req,
1440 [out,ref] uint32 *level_out,
1441 [out,ref,switch_is(*level_out)] drsuapi_DsAddEntryCtr *ctr
1444 /*****************/
1445 /* Function 0x12 */
1446 typedef bitmap {
1447 DRSUAPI_DS_EXECUTE_KCC_ASYNCHRONOUS_OPERATION = 0x00000001,
1448 DRSUAPI_DS_EXECUTE_KCC_DAMPED = 0x00000002
1449 } drsuapi_DsExecuteKCCFlags;
1451 typedef struct {
1452 uint32 taskID;
1453 drsuapi_DsExecuteKCCFlags flags;
1454 } drsuapi_DsExecuteKCC1;
1456 typedef [switch_type(uint32)] union {
1457 [case(1)] drsuapi_DsExecuteKCC1 ctr1;
1458 } drsuapi_DsExecuteKCCRequest;
1460 WERROR drsuapi_DsExecuteKCC(
1461 [in] policy_handle *bind_handle,
1462 [in] uint32 level,
1463 [in, ref, switch_is(level)] drsuapi_DsExecuteKCCRequest *req
1466 /*****************/
1467 /* Function 0x13 */
1468 typedef [v1_enum] enum {
1469 DRSUAPI_DS_REPLICA_GET_INFO = 1,
1470 DRSUAPI_DS_REPLICA_GET_INFO2 = 2
1471 } drsuapi_DsReplicaGetInfoLevel;
1473 typedef [v1_enum] enum {
1474 DRSUAPI_DS_REPLICA_INFO_NEIGHBORS = 0,
1475 DRSUAPI_DS_REPLICA_INFO_CURSORS = 1,
1476 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA = 2,
1477 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES = 3,
1478 DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES = 4,
1479 DRSUAPI_DS_REPLICA_INFO_PENDING_OPS = 5,
1480 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA = 6,
1481 DRSUAPI_DS_REPLICA_INFO_CURSORS2 = 7,
1482 DRSUAPI_DS_REPLICA_INFO_CURSORS3 = 8,
1483 DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2 = 9,
1484 DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2 = 10,
1485 DRSUAPI_DS_REPLICA_INFO_REPSTO = -2,
1486 DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS = -4,
1487 DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1 = -5,
1488 DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS = -6
1489 } drsuapi_DsReplicaInfoType;
1491 typedef struct {
1492 drsuapi_DsReplicaInfoType info_type;
1493 [charset(UTF16),string] uint16 *object_dn;
1494 GUID source_dsa_guid;
1495 } drsuapi_DsReplicaGetInfoRequest1;
1497 typedef struct {
1498 drsuapi_DsReplicaInfoType info_type;
1499 [charset(UTF16),string] uint16 *object_dn;
1500 GUID source_dsa_guid;
1501 uint32 flags;
1502 [charset(UTF16),string] uint16 *attribute_name;
1503 [charset(UTF16),string] uint16 *value_dn_str;
1504 uint32 enumeration_context;
1505 } drsuapi_DsReplicaGetInfoRequest2;
1507 typedef [switch_type(drsuapi_DsReplicaGetInfoLevel)] union {
1508 [case(DRSUAPI_DS_REPLICA_GET_INFO)] drsuapi_DsReplicaGetInfoRequest1 req1;
1509 [case(DRSUAPI_DS_REPLICA_GET_INFO2)] drsuapi_DsReplicaGetInfoRequest2 req2;
1510 } drsuapi_DsReplicaGetInfoRequest;
1512 typedef struct {
1513 [charset(UTF16),string] uint16 *naming_context_dn;
1514 [charset(UTF16),string] uint16 *source_dsa_obj_dn;
1515 [charset(UTF16),string] uint16 *source_dsa_address;
1516 [charset(UTF16),string] uint16 *transport_obj_dn;
1517 drsuapi_DrsOptions replica_flags;
1518 uint32 reserved;
1519 GUID naming_context_obj_guid;
1520 GUID source_dsa_obj_guid;
1521 GUID source_dsa_invocation_id;
1522 GUID transport_obj_guid;
1523 hyper tmp_highest_usn;
1524 hyper highest_usn;
1525 NTTIME last_success;
1526 NTTIME last_attempt;
1527 WERROR result_last_attempt;
1528 uint32 consecutive_sync_failures;
1529 } drsuapi_DsReplicaNeighbour;
1531 typedef struct {
1532 uint32 count;
1533 uint32 reserved;
1534 [size_is(count)] drsuapi_DsReplicaNeighbour array[];
1535 } drsuapi_DsReplicaNeighbourCtr;
1537 typedef struct {
1538 uint32 count;
1539 uint32 reserved;
1540 [size_is(count)] drsuapi_DsReplicaCursor array[];
1541 } drsuapi_DsReplicaCursorCtr;
1543 typedef struct {
1544 [charset(UTF16),string] uint16 *attribute_name;
1545 uint32 version;
1546 NTTIME originating_change_time;
1547 GUID originating_invocation_id;
1548 hyper originating_usn;
1549 hyper local_usn;
1550 } drsuapi_DsReplicaObjMetaData;
1552 typedef struct {
1553 uint32 count;
1554 uint32 reserved;
1555 [size_is(count)] drsuapi_DsReplicaObjMetaData array[];
1556 } drsuapi_DsReplicaObjMetaDataCtr;
1558 typedef struct {
1559 [charset(UTF16),string] uint16 *dsa_obj_dn;
1560 GUID dsa_obj_guid;
1561 NTTIME first_failure;
1562 uint32 num_failures;
1563 WERROR last_result;
1564 } drsuapi_DsReplicaKccDsaFailure;
1566 typedef struct {
1567 uint32 count;
1568 uint32 reserved;
1569 [size_is(count)] drsuapi_DsReplicaKccDsaFailure array[];
1570 } drsuapi_DsReplicaKccDsaFailuresCtr;
1572 typedef enum {
1573 DRSUAPI_DS_REPLICA_OP_TYPE_SYNC = 0,
1574 DRSUAPI_DS_REPLICA_OP_TYPE_ADD = 1,
1575 DRSUAPI_DS_REPLICA_OP_TYPE_DELETE = 2,
1576 DRSUAPI_DS_REPLICA_OP_TYPE_MODIFY = 3,
1577 DRSUAPI_DS_REPLICA_OP_TYPE_UPDATE_REFS = 4
1578 } drsuapi_DsReplicaOpType;
1580 typedef struct {
1581 NTTIME operation_start;
1582 uint32 serial_num; /* unique till reboot */
1583 uint32 priority;
1584 drsuapi_DsReplicaOpType operation_type;
1585 drsuapi_DrsOptions options;
1586 [charset(UTF16),string] uint16 *nc_dn;
1587 [charset(UTF16),string] uint16 *remote_dsa_obj_dn;
1588 [charset(UTF16),string] uint16 *remote_dsa_address;
1589 GUID nc_obj_guid;
1590 GUID remote_dsa_obj_guid;
1591 } drsuapi_DsReplicaOp;
1593 typedef struct {
1594 NTTIME time;
1595 uint32 count;
1596 [size_is(count)] drsuapi_DsReplicaOp array[];
1597 } drsuapi_DsReplicaOpCtr;
1599 typedef struct {
1600 [charset(UTF16),string] uint16 *attribute_name;
1601 [charset(UTF16),string] uint16 *object_dn;
1602 [value(ndr_size_DATA_BLOB(0,binary,0))] uint32 __ndr_size_binary;
1603 DATA_BLOB *binary;
1604 NTTIME deleted;
1605 NTTIME created;
1606 uint32 version;
1607 NTTIME originating_change_time;
1608 GUID originating_invocation_id;
1609 hyper originating_usn;
1610 hyper local_usn;
1611 } drsuapi_DsReplicaAttrValMetaData;
1613 typedef struct {
1614 uint32 count;
1615 uint32 enumeration_context;
1616 [size_is(count)] drsuapi_DsReplicaAttrValMetaData array[];
1617 } drsuapi_DsReplicaAttrValMetaDataCtr;
1619 typedef struct {
1620 uint32 count;
1621 uint32 enumeration_context;
1622 [size_is(count)] drsuapi_DsReplicaCursor2 array[];
1623 } drsuapi_DsReplicaCursor2Ctr;
1625 typedef struct {
1626 GUID source_dsa_invocation_id;
1627 hyper highest_usn;
1628 NTTIME last_sync_success;
1629 [charset(UTF16),string] uint16 *source_dsa_obj_dn;
1630 } drsuapi_DsReplicaCursor3;
1632 typedef struct {
1633 uint32 count;
1634 uint32 enumeration_context;
1635 [size_is(count)] drsuapi_DsReplicaCursor3 array[];
1636 } drsuapi_DsReplicaCursor3Ctr;
1638 typedef struct {
1639 [charset(UTF16),string] uint16 *attribute_name;
1640 uint32 version;
1641 NTTIME originating_change_time;
1642 GUID originating_invocation_id;
1643 hyper originating_usn;
1644 hyper local_usn;
1645 [charset(UTF16),string] uint16 *originating_dsa_dn;
1646 } drsuapi_DsReplicaObjMetaData2;
1648 typedef struct {
1649 uint32 count;
1650 uint32 enumeration_context;
1651 [size_is(count)] drsuapi_DsReplicaObjMetaData2 array[];
1652 } drsuapi_DsReplicaObjMetaData2Ctr;
1654 typedef struct {
1655 [charset(UTF16),string] uint16 *attribute_name;
1656 [charset(UTF16),string] uint16 *object_dn;
1657 [value(ndr_size_DATA_BLOB(0,binary,0))] uint32 __ndr_size_binary;
1658 DATA_BLOB *binary;
1659 NTTIME deleted;
1660 NTTIME created;
1661 uint32 version;
1662 NTTIME originating_change_time;
1663 GUID originating_invocation_id;
1664 hyper originating_usn;
1665 hyper local_usn;
1666 [charset(UTF16),string] uint16 *originating_dsa_dn;
1667 } drsuapi_DsReplicaAttrValMetaData2;
1669 typedef struct {
1670 uint32 count;
1671 uint32 enumeration_context;
1672 [size_is(count)] drsuapi_DsReplicaAttrValMetaData2 array[];
1673 } drsuapi_DsReplicaAttrValMetaData2Ctr;
1675 typedef struct {
1676 hyper u1; /* session number? */
1677 uint32 u2;
1678 uint32 u3;
1679 GUID bind_guid;
1680 NTTIME_1sec bind_time;
1681 [flag(NDR_BIG_ENDIAN)] ipv4address client_ip_address;
1682 uint32 u5; /* this is the same value the client used as pid in the DsBindInfoX struct */
1683 } drsuapi_DsReplicaConnection04;
1685 typedef struct {
1686 [range(0,10000)] uint32 count;
1687 uint32 reserved;
1688 [size_is(count)] drsuapi_DsReplicaConnection04 array[];
1689 } drsuapi_DsReplicaConnection04Ctr;
1691 typedef struct {
1692 [charset(UTF16),string] uint16 *str1;
1693 uint32 u1;
1694 uint32 u2;
1695 uint32 u3;
1696 uint32 u4;
1697 uint32 u5;
1698 hyper u6;
1699 uint32 u7;
1700 } drsuapi_DsReplica06;
1702 typedef struct {
1703 [range(0,256)] uint32 count;
1704 uint32 reserved;
1705 [size_is(count)] drsuapi_DsReplica06 array[];
1706 } drsuapi_DsReplica06Ctr;
1708 typedef [switch_type(drsuapi_DsReplicaInfoType)] union {
1709 [case(DRSUAPI_DS_REPLICA_INFO_NEIGHBORS)] drsuapi_DsReplicaNeighbourCtr *neighbours;
1710 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS)] drsuapi_DsReplicaCursorCtr *cursors;
1711 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA)] drsuapi_DsReplicaObjMetaDataCtr *objmetadata;
1712 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_CONNECT_FAILURES)] drsuapi_DsReplicaKccDsaFailuresCtr *connectfailures;
1713 [case(DRSUAPI_DS_REPLICA_INFO_KCC_DSA_LINK_FAILURES)] drsuapi_DsReplicaKccDsaFailuresCtr *linkfailures;
1714 [case(DRSUAPI_DS_REPLICA_INFO_PENDING_OPS)] drsuapi_DsReplicaOpCtr *pendingops;
1715 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA)] drsuapi_DsReplicaAttrValMetaDataCtr *attrvalmetadata;
1716 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS2)] drsuapi_DsReplicaCursor2Ctr *cursors2;
1717 [case(DRSUAPI_DS_REPLICA_INFO_CURSORS3)] drsuapi_DsReplicaCursor3Ctr *cursors3;
1718 [case(DRSUAPI_DS_REPLICA_INFO_OBJ_METADATA2)] drsuapi_DsReplicaObjMetaData2Ctr *objmetadata2;
1719 [case(DRSUAPI_DS_REPLICA_INFO_ATTRIBUTE_VALUE_METADATA2)] drsuapi_DsReplicaAttrValMetaData2Ctr *attrvalmetadata2;
1720 [case(DRSUAPI_DS_REPLICA_INFO_REPSTO)] drsuapi_DsReplicaNeighbourCtr *repsto;
1721 [case(DRSUAPI_DS_REPLICA_INFO_CLIENT_CONTEXTS)] drsuapi_DsReplicaConnection04Ctr *clientctx;
1722 [case(DRSUAPI_DS_REPLICA_INFO_UPTODATE_VECTOR_V1)] drsuapi_DsReplicaCursorCtrEx *udv1;
1723 [case(DRSUAPI_DS_REPLICA_INFO_SERVER_OUTGOING_CALLS)] drsuapi_DsReplica06Ctr *srvoutgoingcalls;
1724 } drsuapi_DsReplicaInfo;
1726 WERROR drsuapi_DsReplicaGetInfo(
1727 [in] policy_handle *bind_handle,
1728 [in] drsuapi_DsReplicaGetInfoLevel level,
1729 [in,ref,switch_is(level)] drsuapi_DsReplicaGetInfoRequest *req,
1730 [out,ref] drsuapi_DsReplicaInfoType *info_type,
1731 [out,ref,switch_is(*info_type)] drsuapi_DsReplicaInfo *info
1734 /*****************/
1735 /* Function 0x14 */
1736 [todo] WERROR DRSUAPI_ADD_SID_HISTORY();
1738 /*****************/
1739 /* Function 0x15 */
1741 typedef struct {
1742 [range(0,10000)] uint32 num_entries;
1743 [size_is(num_entries)] drsuapi_DsGetMembershipsCtr1 **ctrl_array;
1744 } drsuapi_DsGetMemberships2Ctr1;
1746 typedef [switch_type(uint32)] union {
1747 [case(1)] drsuapi_DsGetMembershipsCtr1 ctr1;
1748 } drsuapi_DsGetMemberships2Ctr;
1750 typedef struct {
1751 [range(1,10000)] uint32 num_req;
1752 [size_is(num_req)] drsuapi_DsGetMembershipsRequest1 **req_array;
1753 } drsuapi_DsGetMemberships2Request1;
1755 typedef [switch_type(uint32)] union {
1756 [case(1)] drsuapi_DsGetMemberships2Request1 req1;
1757 } drsuapi_DsGetMemberships2Request;
1759 WERROR drsuapi_DsGetMemberships2(
1760 [in] policy_handle *bind_handle,
1761 [in] uint32 level,
1762 [in,ref] [switch_is(level)] drsuapi_DsGetMemberships2Request *req,
1763 [out,ref] uint32 *level_out,
1764 [out,ref] [switch_is(*level_out)] drsuapi_DsGetMemberships2Ctr *ctr
1767 /*****************/
1768 /* Function 0x16 */
1769 [todo] WERROR DRSUAPI_REPLICA_VERIFY_OBJECTS();
1771 /*****************/
1772 /* Function 0x17 */
1773 [todo] WERROR DRSUAPI_GET_OBJECT_EXISTENCE();
1775 /*****************/
1776 /* Function 0x18 */
1777 typedef struct {
1778 WERROR error_code;
1779 uint32 site_cost;
1780 } drsuapi_DsSiteCostInfo;
1782 typedef struct {
1783 [range(0,10000)] uint32 num_info;
1784 [size_is(num_info)] drsuapi_DsSiteCostInfo *info;
1785 [value(0)] uint32 flags_reserved;
1786 } drsuapi_QuerySitesByCostCtr1;
1788 typedef [switch_type(uint32)] union {
1789 [case(1)] drsuapi_QuerySitesByCostCtr1 ctr1;
1790 } drsuapi_QuerySitesByCostCtr;
1792 typedef struct {
1793 [charset(UTF16),string] uint16 *site_from;
1794 [range(1,10000)] uint32 num_req;
1795 [size_is(num_req)] [charset(UTF16),string] uint16 **site_to;
1796 uint32 flags;
1797 } drsuapi_QuerySitesByCostRequest1;
1799 typedef [switch_type(uint32)] union {
1800 [case(1)] drsuapi_QuerySitesByCostRequest1 req1;
1801 } drsuapi_QuerySitesByCostRequest;
1803 WERROR drsuapi_QuerySitesByCost(
1804 [in] policy_handle *bind_handle,
1805 [in] uint32 level,
1806 [in,ref] [switch_is(level)] drsuapi_QuerySitesByCostRequest *req,
1807 [out,ref] uint32 *level_out,
1808 [out,ref] [switch_is(*level_out)] drsuapi_QuerySitesByCostCtr *ctr