librpc/idl/drsuapi.idl

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