source4/librpc/idl/samr.idl

   1 #include "idl_types.h"
   2
   3 /*
   4   samr interface definition
   5 */
   6
   7 /*
   8   Thanks to Todd Sabin for some information from his samr.idl in acltools
   9 */
  10
  11 [ uuid("12345778-1234-abcd-ef00-0123456789ac"),
  12   version(1.0),
  13   endpoint("ncacn_np:[\\pipe\\samr]","ncacn_ip_tcp:", "ncalrpc:"),
  14   pointer_default(unique),
  15   pointer_default_top(unique),
  16   depends(lsa,security)
  17 ] interface samr
  18 {
  19         /* account control (acct_flags) bits */
  20         typedef [public,bitmap32bit] bitmap {
  21                 ACB_DISABLED  = 0x00000001,  /* 1 = User account disabled */
  22                 ACB_HOMDIRREQ = 0x00000002,  /* 1 = Home directory required */
  23                 ACB_PWNOTREQ  = 0x00000004,  /* 1 = User password not required */
  24                 ACB_TEMPDUP   = 0x00000008,  /* 1 = Temporary duplicate account */
  25                 ACB_NORMAL    = 0x00000010,  /* 1 = Normal user account */
  26                 ACB_MNS       = 0x00000020,  /* 1 = MNS logon user account */
  27                 ACB_DOMTRUST  = 0x00000040,  /* 1 = Interdomain trust account */
  28                 ACB_WSTRUST   = 0x00000080,  /* 1 = Workstation trust account */
  29                 ACB_SVRTRUST  = 0x00000100,  /* 1 = Server trust account */
  30                 ACB_PWNOEXP   = 0x00000200,  /* 1 = User password does not expire */
  31                 ACB_AUTOLOCK  = 0x00000400   /* 1 = Account auto locked */
  32         } samr_AcctFlags;
  33
  34         /******************/
  35         /* Function: 0x00 */
  36         NTSTATUS samr_Connect (
  37                 /* notice the lack of [string] */
  38                 [in]       uint16 *system_name,
  39                 [in]       uint32 access_mask,
  40                 [out,ref]  policy_handle *connect_handle
  41                 );
  42
  43
  44         /******************/
  45         /* Function: 0x01 */
  46         NTSTATUS samr_Close (
  47                 [in,out,ref]  policy_handle *handle
  48                 );
  49
  50         /******************/
  51         /* Function: 0x02 */
  52
  53         NTSTATUS samr_SetSecurity (
  54                 [in,ref]          policy_handle *handle,
  55                 [in]              uint32 sec_info,
  56                 [in,ref]          sec_desc_buf *sdbuf
  57                 );
  58
  59         /******************/
  60         /* Function: 0x03 */
  61
  62         NTSTATUS samr_QuerySecurity (
  63                 [in,ref]          policy_handle *handle,
  64                 [in]              uint32 sec_info,
  65                 [out]             sec_desc_buf *sdbuf
  66                 );
  67
  68         /******************/
  69         /* Function: 0x04 */
  70
  71         /*
  72           shutdown the SAM - once you call this the SAM will be dead
  73         */
  74         NTSTATUS samr_Shutdown (
  75                 [in,ref]   policy_handle *connect_handle
  76                 );
  77
  78         /******************/
  79         /* Function: 0x05 */
  80         typedef struct {
  81                 [value(2*strlen_m(r->string))] uint16 length;
  82                 [value(r->length)] uint16 size;
  83                 unistr_noterm *string;
  84         } samr_String;
  85
  86         NTSTATUS samr_LookupDomain (
  87                 [in,ref]  policy_handle *connect_handle,
  88                 [in,ref]  samr_String *domain_name,
  89                 [out]     dom_sid2 *sid
  90                 );
  91
  92
  93         /******************/
  94         /* Function: 0x06 */
  95
  96         typedef struct {
  97                 uint32 idx;
  98                 samr_String name;
  99         } samr_SamEntry;
 100
 101         typedef struct {
 102                 uint32 count;
 103                 [size_is(count)] samr_SamEntry *entries[];
 104         } samr_SamArray;
 105
 106         NTSTATUS samr_EnumDomains (
 107                 [in,ref]      policy_handle *connect_handle,
 108                 [in,out,ref]  uint32 *resume_handle,
 109                 [in]          uint32 buf_size,
 110                 [out]         samr_SamArray *sam,
 111                 [out]         uint32 num_entries
 112                 );
 113
 114
 115         /************************/
 116         /* Function    0x07     */
 117         NTSTATUS samr_OpenDomain(
 118                 [in,ref]      policy_handle *connect_handle,
 119                 [in]          uint32 access_mask,
 120                 [in,ref]      dom_sid2 *sid,
 121                 [out,ref]     policy_handle *domain_handle
 122                 );
 123
 124         /************************/
 125         /* Function    0x08     */
 126         /* server roles */
 127         typedef [v1_enum] enum {
 128                 ROLE_STANDALONE    = 0,
 129                 ROLE_DOMAIN_MEMBER = 1,
 130                 ROLE_DOMAIN_BDC    = 2,
 131                 ROLE_DOMAIN_PDC    = 3
 132         } samr_Role;
 133
 134         typedef struct {
 135                 uint16 min_password_length;
 136                 uint16 password_history_length;
 137                 uint32 password_properties;
 138                 /* yes, these are signed. They are in negative 100ns */
 139                 dlong  max_password_age;
 140                 dlong  min_password_age;
 141         } samr_DomInfo1;
 142
 143         typedef struct {
 144                 NTTIME force_logoff_time;
 145                 samr_String comment;
 146                 samr_String domain_name;
 147                 samr_String primary; /* PDC name if this is a BDC */
 148                 udlong sequence_num;
 149                 uint32 unknown2;
 150                 samr_Role role;
 151                 uint32 unknown3;
 152                 uint32 num_users;
 153                 uint32 num_groups;
 154                 uint32 num_aliases;
 155         } samr_DomInfo2;
 156
 157         typedef struct {
 158                 NTTIME force_logoff_time;
 159         } samr_DomInfo3;
 160
 161         typedef struct {
 162                 samr_String comment;
 163         } samr_DomInfo4;
 164
 165         typedef struct {
 166                 samr_String domain_name;
 167         } samr_DomInfo5;
 168
 169         typedef struct {
 170                 samr_String primary;
 171         } samr_DomInfo6;
 172
 173         typedef struct {
 174                 samr_Role role;
 175         } samr_DomInfo7;
 176
 177         typedef struct {
 178                 hyper sequence_num;
 179                 NTTIME domain_create_time;
 180         } samr_DomInfo8;
 181
 182         typedef struct {
 183                 uint32 unknown; /* w2k3 returns 1 */
 184         } samr_DomInfo9;
 185
 186         typedef struct {
 187                 samr_DomInfo2 info2;
 188                 hyper lockout_duration;
 189                 hyper lockout_window;
 190                 uint16 lockout_threshold;
 191         } samr_DomInfo11;
 192
 193         typedef struct {
 194                 hyper lockout_duration;
 195                 hyper lockout_window;
 196                 uint16 lockout_threshold;
 197         } samr_DomInfo12;
 198
 199         typedef struct {
 200                 hyper sequence_num;
 201                 NTTIME domain_create_time;
 202                 uint32 unknown1;
 203                 uint32 unknown2;
 204         } samr_DomInfo13;
 205
 206         typedef [switch_type(uint16)] union {
 207                 [case(1)] samr_DomInfo1 info1;
 208                 [case(2)] samr_DomInfo2 info2;
 209                 [case(3)] samr_DomInfo3 info3;
 210                 [case(4)] samr_DomInfo4 info4;
 211                 [case(5)] samr_DomInfo5 info5;
 212                 [case(6)] samr_DomInfo6 info6;
 213                 [case(7)] samr_DomInfo7 info7;
 214                 [case(8)] samr_DomInfo8 info8;
 215                 [case(9)] samr_DomInfo9 info9;
 216                 [case(11)] samr_DomInfo11 info11;
 217                 [case(12)] samr_DomInfo12 info12;
 218                 [case(13)] samr_DomInfo13 info13;
 219         } samr_DomainInfo;
 220
 221         NTSTATUS samr_QueryDomainInfo(
 222                 [in,ref]      policy_handle *domain_handle,
 223                 [in]          uint16 level,
 224                 [out,switch_is(level)] samr_DomainInfo *info
 225                 );
 226
 227         /************************/
 228         /* Function    0x09     */
 229         /*
 230           only levels 1, 3, 4, 6, 7, 9, 12 are valid for this
 231           call in w2k3
 232         */
 233         NTSTATUS samr_SetDomainInfo(
 234                 [in,ref]      policy_handle *domain_handle,
 235                 [in]          uint16 level,
 236                 [in,switch_is(level),ref] samr_DomainInfo *info
 237                 );
 238
 239
 240         /************************/
 241         /* Function    0x0a     */
 242         NTSTATUS samr_CreateDomainGroup(
 243                 [in,ref]      policy_handle *domain_handle,
 244                 [in,ref]      samr_String *name,
 245                 [in]          uint32 access_mask,
 246                 [out,ref]     policy_handle *group_handle,
 247                 [out,ref]     uint32 *rid
 248                 );
 249
 250
 251         /************************/
 252         /* Function    0x0b     */
 253         NTSTATUS samr_EnumDomainGroups(
 254                 [in,ref]      policy_handle *domain_handle,
 255                 [in,out,ref]  uint32 *resume_handle,
 256                 [in]          uint32 max_size,
 257                 [out]         samr_SamArray *sam,
 258                 [out]         uint32 num_entries
 259                 );
 260
 261         /************************/
 262         /* Function    0x0c     */
 263         NTSTATUS samr_CreateUser(
 264                 [in,ref]      policy_handle *domain_handle,
 265                 [in,ref]      samr_String *account_name,
 266                 [in]          uint32 access_mask,
 267                 [out,ref]     policy_handle *user_handle,
 268                 [out,ref]     uint32 *rid
 269                 );
 270
 271         /************************/
 272         /* Function    0x0d     */
 273
 274
 275         /* w2k3 treats max_size as max_users*54 and sets the
 276            resume_handle as the rid of the last user sent
 277         */
 278         const int SAMR_ENUM_USERS_MULTIPLIER = 54;
 279
 280         NTSTATUS samr_EnumDomainUsers(
 281                 [in,ref]      policy_handle *domain_handle,
 282                 [in,out,ref]  uint32 *resume_handle,
 283                 [in]          samr_AcctFlags acct_flags,
 284                 [in]          uint32 max_size,
 285                 [out]         samr_SamArray *sam,
 286                 [out]         uint32 num_entries
 287                 );
 288
 289         /************************/
 290         /* Function    0x0e     */
 291         NTSTATUS samr_CreateDomAlias(
 292                 [in,ref]      policy_handle *domain_handle,
 293                 [in,ref]      samr_String   *alias_name,
 294                 [in]          uint32         access_mask,
 295                 [out,ref]     policy_handle *alias_handle,
 296                 [out,ref]     uint32        *rid
 297                 );
 298
 299         /************************/
 300         /* Function    0x0f     */
 301         NTSTATUS samr_EnumDomainAliases(
 302                 [in,ref]      policy_handle *domain_handle,
 303                 [in,out,ref]  uint32 *resume_handle,
 304                 [in]          samr_AcctFlags acct_flags,
 305                 [out]         samr_SamArray *sam,
 306                 [out]         uint32 num_entries
 307                 );
 308
 309         /************************/
 310         /* Function    0x10     */
 311
 312         typedef struct {
 313                 [range(0,1024)]  uint32 count;
 314                 [size_is(count)] uint32 *ids[];
 315         } samr_Ids;
 316
 317         NTSTATUS samr_GetAliasMembership(
 318                 [in,ref]      policy_handle *domain_handle,
 319                 [in,ref]      lsa_SidArray  *sids,
 320                 [out,ref]     samr_Ids *rids
 321                 );
 322
 323         /************************/
 324         /* Function    0x11     */
 325
 326         NTSTATUS samr_LookupNames(
 327                 [in,ref]      policy_handle *domain_handle,
 328                 [in,range(0,1000)] uint32 num_names,
 329                 [in,size_is(1000),length_is(num_names)] samr_String names[],
 330                 [out]         samr_Ids rids,
 331                 [out]         samr_Ids types
 332                 );
 333
 334
 335         /************************/
 336         /* Function    0x12     */
 337
 338         typedef struct {
 339                 uint32 count;
 340                 [size_is(count)] samr_String *names;
 341         } samr_Strings;
 342
 343         NTSTATUS samr_LookupRids(
 344                 [in,ref]      policy_handle *domain_handle,
 345                 [in,range(0,1000)] uint32 num_rids,
 346                 [in,size_is(1000),length_is(num_rids)] uint32 rids[],
 347                 [out]         samr_Strings names,
 348                 [out]         samr_Ids types
 349                 );
 350
 351         /************************/
 352         /* Function    0x13     */
 353         NTSTATUS samr_OpenGroup(
 354                 [in,ref]      policy_handle *domain_handle,
 355                 [in]          uint32 access_mask,
 356                 [in]          uint32 rid,
 357                 [out,ref]     policy_handle *group_handle
 358                 );
 359
 360
 361         /************************/
 362         /* Function    0x14     */
 363
 364         typedef struct {
 365                 samr_String name;
 366                 uint32 attributes;
 367                 uint32 num_members;
 368                 samr_String description;
 369         } samr_GroupInfoAll;
 370
 371         typedef struct {
 372                 uint32 unknown;
 373         } samr_GroupInfoX;
 374
 375         typedef struct {
 376                 samr_String description;
 377         } samr_GroupInfoDesciption;
 378
 379         typedef enum {
 380                 GROUPINFOALL          = 1,
 381                 GROUPINFONAME         = 2,
 382                 GROUPINFOX            = 3,
 383                 GROUPINFODESCRIPTION  = 4,
 384                 GROUPINFOALL2         = 5
 385         } samr_GroupInfoEnum;
 386
 387         typedef [switch_type(samr_GroupInfoEnum)] union {
 388                 [case(GROUPINFOALL)]         samr_GroupInfoAll    all;
 389                 [case(GROUPINFONAME)]        samr_String            name;
 390                 [case(GROUPINFOX)]           samr_GroupInfoX      unknown;
 391                 [case(GROUPINFODESCRIPTION)] samr_String            description;
 392                 [case(GROUPINFOALL2)]        samr_GroupInfoAll    all2;
 393         } samr_GroupInfo;
 394
 395         NTSTATUS samr_QueryGroupInfo(
 396                 [in,ref]                  policy_handle *group_handle,
 397                 [in]                      samr_GroupInfoEnum level,
 398                 [out,switch_is(level)]    samr_GroupInfo *info
 399                 );
 400
 401         /************************/
 402         /* Function    0x15     */
 403         NTSTATUS samr_SetGroupInfo(
 404                 [in,ref]                  policy_handle *group_handle,
 405                 [in]                      samr_GroupInfoEnum level,
 406                 [in,switch_is(level),ref] samr_GroupInfo *info
 407                 );
 408
 409         /************************/
 410         /* Function    0x16     */
 411         NTSTATUS samr_AddGroupMember(
 412                 [in,ref]                  policy_handle *group_handle,
 413                 [in]                      uint32 rid,
 414                 [in]                      uint32 flags
 415                 );
 416
 417         /************************/
 418         /* Function    0x17     */
 419         NTSTATUS samr_DeleteDomainGroup(
 420                 [in,out,ref]   policy_handle *group_handle
 421                 );
 422
 423         /************************/
 424         /* Function    0x18     */
 425         NTSTATUS samr_DeleteGroupMember(
 426                 [in,ref]                  policy_handle *group_handle,
 427                 [in]                      uint32 rid
 428                 );
 429
 430
 431         /************************/
 432         /* Function    0x19     */
 433         typedef struct {
 434                 uint32 count;
 435                 [size_is(count)] uint32 *rids[];
 436                 [size_is(count)] uint32 *types[];
 437         } samr_RidTypeArray;
 438
 439         NTSTATUS samr_QueryGroupMember(
 440                 [in,ref]  policy_handle *group_handle,
 441                 [out]     samr_RidTypeArray *rids
 442                 );
 443
 444
 445         /************************/
 446         /* Function    0x1a     */
 447
 448         /*
 449           win2003 seems to accept any data at all for the two integers
 450           below, and doesn't seem to do anything with them that I can
 451           see. Weird. I really expected the first integer to be a rid
 452           and the second to be the attributes for that rid member.
 453         */
 454         NTSTATUS samr_SetMemberAttributesOfGroup(
 455                 [in,ref]  policy_handle *group_handle,
 456                 [in]      uint32 unknown1,
 457                 [in]      uint32 unknown2
 458                 );
 459
 460
 461         /************************/
 462         /* Function    0x1b     */
 463         NTSTATUS samr_OpenAlias (
 464                 [in,ref]      policy_handle *domain_handle,
 465                 [in]          uint32 access_mask,
 466                 [in]          uint32 rid,
 467                 [out,ref]     policy_handle *alias_handle
 468                 );
 469
 470
 471         /************************/
 472         /* Function    0x1c     */
 473
 474         typedef struct {
 475                 samr_String name;
 476                 uint32 num_members;
 477                 samr_String description;
 478         } samr_AliasInfoAll;
 479
 480         typedef enum {
 481                 ALIASINFOALL          = 1,
 482                 ALIASINFONAME         = 2,
 483                 ALIASINFODESCRIPTION  = 3
 484         } samr_AliasInfoEnum;
 485
 486         typedef [switch_type(samr_AliasInfoEnum)] union {
 487                 [case(ALIASINFOALL)] samr_AliasInfoAll all;
 488                 [case(ALIASINFONAME)] samr_String name;
 489                 [case(ALIASINFODESCRIPTION)] samr_String description;
 490         } samr_AliasInfo;
 491
 492         NTSTATUS samr_QueryAliasInfo(
 493                 [in,ref]                  policy_handle  *alias_handle,
 494                 [in]                      samr_AliasInfoEnum      level,
 495                 [out,switch_is(level)]    samr_AliasInfo *info
 496                 );
 497
 498         /************************/
 499         /* Function    0x1d     */
 500         NTSTATUS samr_SetAliasInfo(
 501                 [in,ref]                  policy_handle  *alias_handle,
 502                 [in]                      samr_AliasInfoEnum      level,
 503                 [in,switch_is(level),ref] samr_AliasInfo *info
 504                 );
 505
 506         /************************/
 507         /* Function    0x1e     */
 508         NTSTATUS samr_DeleteDomAlias(
 509                 [in,out,ref]  policy_handle *alias_handle
 510                 );
 511
 512         /************************/
 513         /* Function    0x1f     */
 514         NTSTATUS samr_AddAliasMember(
 515                 [in,ref]  policy_handle *alias_handle,
 516                 [in,ref]  dom_sid2      *sid
 517                 );
 518
 519         /************************/
 520         /* Function    0x20     */
 521         NTSTATUS samr_DeleteAliasMember(
 522                 [in,ref] policy_handle *alias_handle,
 523                 [in,ref] dom_sid2      *sid
 524                 );
 525
 526         /************************/
 527         /* Function    0x21     */
 528         NTSTATUS samr_GetMembersInAlias(
 529                 [in,ref]   policy_handle *alias_handle,
 530                 [out,ref]  lsa_SidArray    *sids
 531                 );
 532
 533         /************************/
 534         /* Function    0x22     */
 535         NTSTATUS samr_OpenUser(
 536                 [in,ref]      policy_handle *domain_handle,
 537                 [in]          uint32 access_mask,
 538                 [in]          uint32 rid,
 539                 [out,ref]     policy_handle *user_handle
 540                 );
 541
 542         /************************/
 543         /* Function    0x23     */
 544         NTSTATUS samr_DeleteUser(
 545                 [in,out,ref]   policy_handle *user_handle
 546                 );
 547
 548         /************************/
 549         /* Function    0x24     */
 550         typedef struct {
 551                 samr_String account_name;
 552                 samr_String full_name;
 553                 uint32 primary_gid;
 554                 samr_String description;
 555                 samr_String comment;
 556         } samr_UserInfo1;
 557
 558         typedef struct {
 559                 samr_String comment;
 560                 samr_String unknown; /* settable, but doesn't stick. probably obsolete */
 561                 uint16 country_code;
 562                 uint16 code_page;
 563         } samr_UserInfo2;
 564
 565         /* this is also used in samr and netlogon */
 566         typedef [public, flag(NDR_PAHEX)] struct {
 567                 uint16 units_per_week;
 568                 [size_is(1260), length_is(units_per_week/8)] uint8 *bits[];
 569         } samr_LogonHours;
 570
 571         typedef struct {
 572                 samr_String account_name;
 573                 samr_String full_name;
 574                 uint32 rid;
 575                 uint32 primary_gid;
 576                 samr_String home_directory;
 577                 samr_String home_drive;
 578                 samr_String logon_script;
 579                 samr_String profile_path;
 580                 samr_String workstations;
 581                 NTTIME last_logon;
 582                 NTTIME last_logoff;
 583                 NTTIME last_password_change;
 584                 NTTIME allow_password_change;
 585                 NTTIME force_password_change;
 586                 samr_LogonHours logon_hours;
 587                 uint16 bad_password_count;
 588                 uint16 logon_count;
 589                 samr_AcctFlags acct_flags;
 590         } samr_UserInfo3;
 591
 592         typedef struct {
 593                 samr_LogonHours logon_hours;
 594         } samr_UserInfo4;
 595
 596         typedef struct {
 597                 samr_String account_name;
 598                 samr_String full_name;
 599                 uint32 rid;
 600                 uint32 primary_gid;
 601                 samr_String home_directory;
 602                 samr_String home_drive;
 603                 samr_String logon_script;
 604                 samr_String profile_path;
 605                 samr_String description;
 606                 samr_String workstations;
 607                 NTTIME last_logon;
 608                 NTTIME last_logoff;
 609                 samr_LogonHours logon_hours;
 610                 uint16 bad_password_count;
 611                 uint16 logon_count;
 612                 NTTIME last_password_change;
 613                 NTTIME acct_expiry;
 614                 samr_AcctFlags acct_flags;
 615         } samr_UserInfo5;
 616
 617         typedef struct {
 618                 samr_String account_name;
 619                 samr_String full_name;
 620         } samr_UserInfo6;
 621
 622         typedef struct {
 623                 samr_String account_name;
 624         } samr_UserInfo7;
 625
 626         typedef struct {
 627                 samr_String full_name;
 628         } samr_UserInfo8;
 629
 630         typedef struct {
 631                 uint32 primary_gid;
 632         } samr_UserInfo9;
 633
 634         typedef struct {
 635                 samr_String home_directory;
 636                 samr_String home_drive;
 637         } samr_UserInfo10;
 638
 639         typedef struct {
 640                 samr_String logon_script;
 641         } samr_UserInfo11;
 642
 643         typedef struct {
 644                 samr_String profile_path;
 645         } samr_UserInfo12;
 646
 647         typedef struct {
 648                 samr_String description;
 649         } samr_UserInfo13;
 650
 651         typedef struct {
 652                 samr_String workstations;
 653         } samr_UserInfo14;
 654
 655         typedef struct {
 656                 samr_AcctFlags acct_flags;
 657         } samr_UserInfo16;
 658
 659         typedef struct {
 660                 NTTIME acct_expiry;
 661         } samr_UserInfo17;
 662
 663         typedef struct {
 664                 samr_String parameters;
 665         } samr_UserInfo20;
 666
 667         /* this defines the bits used for fields_present in info21 */
 668         typedef [bitmap32bit] bitmap {
 669                 SAMR_FIELD_ACCOUNT_NAME = 0x00000001,
 670                 SAMR_FIELD_FULL_NAME    = 0x00000002,
 671                 SAMR_FIELD_DESCRIPTION  = 0x00000010,
 672                 SAMR_FIELD_COMMENT      = 0x00000020,
 673                 SAMR_FIELD_LOGON_SCRIPT = 0x00000100,
 674                 SAMR_FIELD_PROFILE_PATH = 0x00000200,
 675                 SAMR_FIELD_WORKSTATIONS = 0x00000400,
 676                 SAMR_FIELD_LOGON_HOURS  = 0x00002000,
 677                 SAMR_FIELD_ACCT_FLAGS   = 0x00100000,
 678                 SAMR_FIELD_PARAMETERS   = 0x00200000,
 679                 SAMR_FIELD_COUNTRY_CODE = 0x00400000,
 680                 SAMR_FIELD_CODE_PAGE    = 0x00800000,
 681                 SAMR_FIELD_PASSWORD     = 0x01000000, /* either of these */
 682                 SAMR_FIELD_PASSWORD2    = 0x02000000 /* two bits seems to work */
 683         } samr_FieldsPresent;
 684
 685         typedef struct {
 686                 NTTIME last_logon;
 687                 NTTIME last_logoff;
 688                 NTTIME last_password_change;
 689                 NTTIME acct_expiry;
 690                 NTTIME allow_password_change;
 691                 NTTIME force_password_change;
 692                 samr_String account_name;
 693                 samr_String full_name;
 694                 samr_String home_directory;
 695                 samr_String home_drive;
 696                 samr_String logon_script;
 697                 samr_String profile_path;
 698                 samr_String description;
 699                 samr_String workstations;
 700                 samr_String comment;
 701                 samr_String parameters;
 702                 samr_String unknown1;
 703                 samr_String unknown2;
 704                 samr_String unknown3;
 705                 uint32 buf_count;
 706                 [size_is(buf_count)] uint8 *buffer[];
 707                 uint32 rid;
 708                 uint32 primary_gid;
 709                 samr_AcctFlags acct_flags;
 710                 samr_FieldsPresent fields_present;
 711                 samr_LogonHours logon_hours;
 712                 uint16 bad_password_count;
 713                 uint16 logon_count;
 714                 uint16 country_code;
 715                 uint16 code_page;
 716                 uint8  nt_password_set;
 717                 uint8  lm_password_set;
 718                 uint8  password_expired;
 719                 uint8  unknown4;
 720         } samr_UserInfo21;
 721
 722         typedef [public, flag(NDR_PAHEX)] struct {
 723                 uint8 data[516];
 724         } samr_CryptPassword;
 725
 726         typedef struct {
 727                 samr_UserInfo21 info;
 728                 samr_CryptPassword password;
 729         } samr_UserInfo23;
 730
 731         typedef struct {
 732                 samr_CryptPassword password;
 733                 uint16 pw_len;
 734         } samr_UserInfo24;
 735
 736         typedef [flag(NDR_PAHEX)] struct {
 737                 uint8 data[532];
 738         } samr_CryptPasswordEx;
 739
 740         typedef struct {
 741                 samr_UserInfo21 info;
 742                 samr_CryptPasswordEx password;
 743         } samr_UserInfo25;
 744
 745         typedef struct {
 746                 samr_CryptPasswordEx password;
 747                 uint8 pw_len;
 748         } samr_UserInfo26;
 749
 750         typedef [switch_type(uint16)] union {
 751                 [case(1)] samr_UserInfo1 info1;
 752                 [case(2)] samr_UserInfo2 info2;
 753                 [case(3)] samr_UserInfo3 info3;
 754                 [case(4)] samr_UserInfo4 info4;
 755                 [case(5)] samr_UserInfo5 info5;
 756                 [case(6)] samr_UserInfo6 info6;
 757                 [case(7)] samr_UserInfo7 info7;
 758                 [case(8)] samr_UserInfo8 info8;
 759                 [case(9)] samr_UserInfo9 info9;
 760                 [case(10)] samr_UserInfo10 info10;
 761                 [case(11)] samr_UserInfo11 info11;
 762                 [case(12)] samr_UserInfo12 info12;
 763                 [case(13)] samr_UserInfo13 info13;
 764                 [case(14)] samr_UserInfo14 info14;
 765                 [case(16)] samr_UserInfo16 info16;
 766                 [case(17)] samr_UserInfo17 info17;
 767                 [case(20)] samr_UserInfo20 info20;
 768                 [case(21)] samr_UserInfo21 info21;
 769                 [case(23)] samr_UserInfo23 info23;
 770                 [case(24)] samr_UserInfo24 info24;
 771                 [case(25)] samr_UserInfo25 info25;
 772                 [case(26)] samr_UserInfo26 info26;
 773         } samr_UserInfo;
 774
 775         NTSTATUS samr_QueryUserInfo(
 776                 [in,ref]                  policy_handle *user_handle,
 777                 [in]                      uint16 level,
 778                 [out,switch_is(level)]    samr_UserInfo *info
 779                 );
 780
 781
 782         /************************/
 783         /* Function    0x25     */
 784         NTSTATUS samr_SetUserInfo(
 785                 [in,ref]                   policy_handle *user_handle,
 786                 [in]                       uint16 level,
 787                 [in,ref,switch_is(level)]  samr_UserInfo *info
 788                 );
 789
 790         /************************/
 791         /* Function    0x26     */
 792         typedef [public, flag(NDR_PAHEX)] struct {
 793                 uint8 hash[16];
 794         } samr_Password;
 795
 796         /*
 797           this is a password change interface that doesn't give
 798           the server the plaintext password. Depricated.
 799         */
 800         NTSTATUS samr_ChangePasswordUser(
 801                 [in,ref]    policy_handle *user_handle,
 802                 [in]        bool8 lm_present,
 803                 [in]        samr_Password *old_lm_crypted,
 804                 [in]        samr_Password *new_lm_crypted,
 805                 [in]        bool8 nt_present,
 806                 [in]        samr_Password *old_nt_crypted,
 807                 [in]        samr_Password *new_nt_crypted,
 808                 [in]        bool8 cross1_present,
 809                 [in]        samr_Password *nt_cross,
 810                 [in]        bool8 cross2_present,
 811                 [in]        samr_Password *lm_cross
 812                 );
 813
 814         /************************/
 815         /* Function    0x27     */
 816
 817         typedef [public] struct {
 818                 uint32 rid;
 819                 uint32 type;
 820         } samr_RidWithType;
 821
 822         typedef [public] struct {
 823                 uint32     count;
 824                 [size_is(count)] samr_RidWithType *rids[];
 825         } samr_RidWithTypeArray;
 826
 827         NTSTATUS samr_GetGroupsForUser(
 828                 [in,ref]   policy_handle *user_handle,
 829                 [out]      samr_RidWithTypeArray  *rids
 830                 );
 831
 832         /************************/
 833         /* Function    0x28     */
 834
 835         typedef struct {
 836                 uint32    idx;
 837                 uint32    rid;
 838                 samr_AcctFlags acct_flags;
 839                 samr_String account_name;
 840                 samr_String full_name;
 841                 samr_String description;
 842         } samr_DispEntryGeneral;
 843
 844         typedef struct {
 845                 uint32 count;
 846                 [size_is(count)] samr_DispEntryGeneral *entries[];
 847         } samr_DispInfoGeneral;
 848
 849         typedef struct {
 850                 uint32    idx;
 851                 uint32    rid;
 852                 samr_AcctFlags acct_flags;
 853                 samr_String account_name;
 854                 samr_String description;
 855         } samr_DispEntryFull;
 856
 857         typedef struct {
 858                 uint32 count;
 859                 [size_is(count)] samr_DispEntryFull *entries[];
 860         } samr_DispInfoFull;
 861
 862         typedef struct {
 863                 [value(strlen_m(r->string))] uint16 length;
 864                 [value(strlen_m(r->string))] uint16 size;
 865                 ascstr_noterm *string;
 866         } samr_AsciiName;
 867
 868         typedef struct {
 869                 uint32    idx;
 870                 samr_AsciiName account_name;
 871         } samr_DispEntryAscii;
 872
 873         typedef struct {
 874                 uint32 count;
 875                 [size_is(count)] samr_DispEntryAscii *entries[];
 876         } samr_DispInfoAscii;
 877
 878         typedef [switch_type(uint16)] union {
 879                 [case(1)] samr_DispInfoGeneral info1;/* users */
 880                 [case(2)] samr_DispInfoFull info2; /* trust accounts? */
 881                 [case(3)] samr_DispInfoFull info3; /* groups */
 882                 [case(4)] samr_DispInfoAscii info4; /* users */
 883                 [case(5)] samr_DispInfoAscii info5; /* groups */
 884         } samr_DispInfo;
 885
 886         NTSTATUS samr_QueryDisplayInfo(
 887                 [in,ref]    policy_handle *domain_handle,
 888                 [in]        uint16 level,
 889                 [in]        uint32 start_idx,
 890                 [in]        uint32 max_entries,
 891                 [in]        uint32 buf_size,
 892                 [out]       uint32 total_size,
 893                 [out]       uint32 returned_size,
 894                 [out,switch_is(level)] samr_DispInfo info
 895                 );
 896
 897
 898         /************************/
 899         /* Function    0x29     */
 900
 901         /*
 902           this seems to be an alphabetic search function. The returned index
 903           is the index for samr_QueryDisplayInfo needed to get names occurring
 904           after the specified name. The supplied name does not need to exist
 905           in the database (for example you can supply just a first letter for
 906           searching starting at that letter)
 907
 908           The level corresponds to the samr_QueryDisplayInfo level
 909         */
 910         NTSTATUS samr_GetDisplayEnumerationIndex(
 911                 [in,ref]    policy_handle *domain_handle,
 912                 [in]        uint16 level,
 913                 [in]        samr_String name,
 914                 [out]       uint32 idx
 915                 );
 916
 917
 918
 919         /************************/
 920         /* Function    0x2a     */
 921
 922         /*
 923           w2k3 returns NT_STATUS_NOT_IMPLEMENTED for this
 924         */
 925         NTSTATUS samr_TestPrivateFunctionsDomain(
 926                 [in,ref]    policy_handle *domain_handle
 927                 );
 928
 929
 930         /************************/
 931         /* Function    0x2b     */
 932
 933         /*
 934           w2k3 returns NT_STATUS_NOT_IMPLEMENTED for this
 935         */
 936         NTSTATUS samr_TestPrivateFunctionsUser(
 937                 [in,ref]    policy_handle *user_handle
 938                 );
 939
 940
 941         /************************/
 942         /* Function    0x2c     */
 943
 944         /* password properties flags */
 945         const uint32 DOMAIN_PASSWORD_COMPLEX         = 0x00000001;
 946         const uint32 DOMAIN_PASSWORD_NO_ANON_CHANGE  = 0x00000002;
 947         const uint32 DOMAIN_PASSWORD_NO_CLEAR_CHANGE = 0x00000004;
 948         const uint32 DOMAIN_PASSWORD_STORE_CLEARTEXT = 0x00000010;
 949         const uint32 DOMAIN_REFUSE_PASSWORD_CHANGE   = 0x00000020;
 950
 951         typedef struct {
 952                 uint16 min_password_length;
 953                 uint32 password_properties;
 954         } samr_PwInfo;
 955
 956         NTSTATUS samr_GetUserPwInfo(
 957                 [in,ref]    policy_handle *user_handle,
 958                 [out]       samr_PwInfo info
 959                 );
 960
 961         /************************/
 962         /* Function    0x2d     */
 963         NTSTATUS samr_RemoveMemberFromForeignDomain(
 964                 [in,ref]    policy_handle *domain_handle,
 965                 [in,ref]    dom_sid2 *sid
 966                 );
 967
 968         /************************/
 969         /* Function    0x2e     */
 970
 971         /*
 972           how is this different from QueryDomainInfo ??
 973         */
 974         NTSTATUS samr_QueryDomainInfo2(
 975                 [in,ref]      policy_handle *domain_handle,
 976                 [in]          uint16 level,
 977                 [out,switch_is(level)] samr_DomainInfo *info
 978                 );
 979
 980         /************************/
 981         /* Function    0x2f     */
 982
 983         /*
 984           how is this different from QueryUserInfo ??
 985         */
 986         NTSTATUS samr_QueryUserInfo2(
 987                 [in,ref]                  policy_handle *user_handle,
 988                 [in]                      uint16 level,
 989                 [out,switch_is(level)]    samr_UserInfo *info
 990                 );
 991
 992         /************************/
 993         /* Function    0x30     */
 994
 995         /*
 996           how is this different from QueryDisplayInfo??
 997         */
 998         NTSTATUS samr_QueryDisplayInfo2(
 999                 [in,ref]    policy_handle *domain_handle,
1000                 [in]        uint16 level,
1001                 [in]        uint32 start_idx,
1002                 [in]        uint32 max_entries,
1003                 [in]        uint32 buf_size,
1004                 [out]       uint32 total_size,
1005                 [out]       uint32 returned_size,
1006                 [out,switch_is(level)] samr_DispInfo info
1007                 );
1008
1009         /************************/
1010         /* Function    0x31     */
1011
1012         /*
1013           how is this different from GetDisplayEnumerationIndex ??
1014         */
1015         NTSTATUS samr_GetDisplayEnumerationIndex2(
1016                 [in,ref]    policy_handle *domain_handle,
1017                 [in]        uint16 level,
1018                 [in]        samr_String name,
1019                 [out]       uint32 idx
1020                 );
1021
1022
1023         /************************/
1024         /* Function    0x32     */
1025         NTSTATUS samr_CreateUser2(
1026                 [in,ref]      policy_handle *domain_handle,
1027                 [in,ref]      samr_String *account_name,
1028                 [in]          samr_AcctFlags acct_flags,
1029                 [in]          uint32 access_mask,
1030                 [out,ref]     policy_handle *user_handle,
1031                 [out,ref]     uint32 *access_granted,
1032                 [out,ref]     uint32 *rid
1033                 );
1034
1035
1036         /************************/
1037         /* Function    0x33     */
1038
1039         /*
1040           another duplicate. There must be a reason ....
1041         */
1042         NTSTATUS samr_QueryDisplayInfo3(
1043                 [in,ref]    policy_handle *domain_handle,
1044                 [in]        uint16 level,
1045                 [in]        uint32 start_idx,
1046                 [in]        uint32 max_entries,
1047                 [in]        uint32 buf_size,
1048                 [out]       uint32 total_size,
1049                 [out]       uint32 returned_size,
1050                 [out,switch_is(level)] samr_DispInfo info
1051                 );
1052
1053         /************************/
1054         /* Function    0x34     */
1055         NTSTATUS samr_AddMultipleMembersToAlias(
1056                 [in,ref]    policy_handle *alias_handle,
1057                 [in,ref]    lsa_SidArray *sids
1058                 );
1059
1060         /************************/
1061         /* Function    0x35     */
1062         NTSTATUS samr_RemoveMultipleMembersFromAlias(
1063                 [in,ref]    policy_handle *alias_handle,
1064                 [in,ref]    lsa_SidArray *sids
1065                 );
1066
1067         /************************/
1068         /* Function    0x36     */
1069
1070         NTSTATUS samr_OemChangePasswordUser2(
1071                 [in]              samr_AsciiName *server,
1072                 [in,ref]          samr_AsciiName *account,
1073                 [in]              samr_CryptPassword *password,
1074                 [in]              samr_Password *hash
1075                 );
1076
1077         /************************/
1078         /* Function    0x37     */
1079         NTSTATUS samr_ChangePasswordUser2(
1080                 [in]              samr_String *server,
1081                 [in,ref]          samr_String *account,
1082                 [in]              samr_CryptPassword *nt_password,
1083                 [in]              samr_Password *nt_verifier,
1084                 [in]              bool8 lm_change,
1085                 [in]              samr_CryptPassword *lm_password,
1086                 [in]              samr_Password *lm_verifier
1087                 );
1088
1089         /************************/
1090         /* Function    0x38     */
1091         NTSTATUS samr_GetDomPwInfo(
1092                 [in]        samr_String *domain_name,
1093                 [out]       samr_PwInfo info
1094                 );
1095
1096         /************************/
1097         /* Function    0x39     */
1098         NTSTATUS samr_Connect2(
1099                 [in] unistr *system_name,
1100                 [in] uint32 access_mask,
1101                 [out,ref]  policy_handle *connect_handle
1102                 );
1103
1104         /************************/
1105         /* Function    0x3a     */
1106         /*
1107           seems to be an exact alias for samr_SetUserInfo()
1108         */
1109         NTSTATUS samr_SetUserInfo2(
1110                 [in,ref]                   policy_handle *user_handle,
1111                 [in]                       uint16 level,
1112                 [in,ref,switch_is(level)]  samr_UserInfo *info
1113                 );
1114
1115         /************************/
1116         /* Function    0x3b     */
1117         /*
1118           this one is mysterious. I have a few guesses, but nothing working yet
1119         */
1120         NTSTATUS samr_SetBootKeyInformation(
1121                 [in,ref]   policy_handle *connect_handle,
1122                 [in]       uint32 unknown1,
1123                 [in]       uint32 unknown2,
1124                 [in]       uint32 unknown3
1125                 );
1126
1127         /************************/
1128         /* Function    0x3c     */
1129         NTSTATUS samr_GetBootKeyInformation(
1130                 [in,ref]   policy_handle *domain_handle,
1131                 [out]      uint32 unknown
1132                 );
1133
1134         /************************/
1135         /* Function    0x3d     */
1136         NTSTATUS samr_Connect3(
1137                 [in] unistr *system_name,
1138                 /* this unknown value seems to be completely ignored by w2k3 */
1139                 [in] uint32 unknown,
1140                 [in] uint32 access_mask,
1141                 [out,ref]  policy_handle *connect_handle
1142                 );
1143
1144         /************************/
1145         /* Function    0x3e     */
1146         NTSTATUS samr_Connect4(
1147                 [in] unistr *system_name,
1148                 [in] uint32 unknown,
1149                 [in] uint32 access_mask,
1150                 [out,ref]  policy_handle *connect_handle
1151                 );
1152
1153         /************************/
1154         /* Function    0x3f     */
1155
1156         typedef [v1_enum] enum {
1157                 SAMR_REJECT_OTHER      = 0,
1158                 SAMR_REJECT_TOO_SHORT  = 1,
1159                 SAMR_REJECT_COMPLEXITY = 2
1160         } samr_RejectReason;
1161
1162         typedef struct {
1163                 samr_RejectReason reason;
1164                 uint32 unknown1;
1165                 uint32 unknown2;
1166         } samr_ChangeReject;
1167
1168         NTSTATUS samr_ChangePasswordUser3(
1169                 [in]              samr_String *server,
1170                 [in,ref]          samr_String *account,
1171                 [in]              samr_CryptPassword *nt_password,
1172                 [in]              samr_Password *nt_verifier,
1173                 [in]              bool8 lm_change,
1174                 [in]              samr_CryptPassword *lm_password,
1175                 [in]              samr_Password *lm_verifier,
1176                 [in]              samr_CryptPassword *password3,
1177                 [out]             samr_DomInfo1 *dominfo,
1178                 [out]             samr_ChangeReject *reject
1179                 );
1180
1181         /************************/
1182         /* Function    0x40      */
1183
1184         typedef struct {
1185                 uint32         unknown1; /* w2k3 gives 3 */
1186                 uint32         unknown2; /* w2k3 gives 0 */
1187         } samr_ConnectInfo1;
1188
1189         typedef union {
1190                 [case(1)]  samr_ConnectInfo1 info1;
1191         } samr_ConnectInfo;
1192
1193         NTSTATUS samr_Connect5(
1194                 [in]       unistr             *system_name,
1195                 [in]       uint32             access_mask,
1196                 [in,out]   uint32             level,
1197                 [in,out,switch_is(level),ref] samr_ConnectInfo *info,
1198                 [out,ref]  policy_handle      *connect_handle
1199                 );
1200
1201         /************************/
1202         /* Function    0x41     */
1203         NTSTATUS samr_RidToSid(
1204                 [in,ref]    policy_handle *domain_handle,
1205                 [in]        uint32        rid,
1206                 [out]       dom_sid2      *sid
1207                 );
1208
1209
1210         /************************/
1211         /* Function    0x42     */
1212
1213         /*
1214           this should set the DSRM password for the server, which is used
1215           when booting into Directory Services Recovery Mode on a DC. Win2003
1216           gives me NT_STATUS_NOT_SUPPORTED
1217         */
1218
1219         NTSTATUS samr_SetDsrmPassword(
1220                 [in]       samr_String *name,
1221                 [in]       uint32 unknown,
1222                 [in]       samr_Password *hash
1223                 );
1224
1225
1226         /************************/
1227         /* Function    0x43     */
1228         /*
1229           I haven't been able to work out the format of this one yet.
1230           Seems to start with a switch level for a union?
1231         */
1232         NTSTATUS samr_ValidatePassword();
1233 }