4 samr interface definition
6 import
"misc.idl", "lsa.idl", "security.idl";
9 Thanks to Todd Sabin for some information from his samr.idl in acltools
12 [ uuid("12345778-1234-abcd-ef00-0123456789ac"),
14 endpoint("ncacn_np:[\\pipe\\samr]","ncacn_ip_tcp:", "ncalrpc:"),
15 pointer_default(unique)
18 typedef bitmap security_secinfo security_secinfo
;
19 typedef bitmap security_GroupAttrs security_GroupAttrs
;
21 /* account control (acct_flags) bits */
22 typedef [public,bitmap32bit
] bitmap
{
23 ACB_DISABLED
= 0x00000001, /* 1 = User account disabled */
24 ACB_HOMDIRREQ
= 0x00000002, /* 1 = Home directory required */
25 ACB_PWNOTREQ
= 0x00000004, /* 1 = User password not required */
26 ACB_TEMPDUP
= 0x00000008, /* 1 = Temporary duplicate account */
27 ACB_NORMAL
= 0x00000010, /* 1 = Normal user account */
28 ACB_MNS
= 0x00000020, /* 1 = MNS logon user account */
29 ACB_DOMTRUST
= 0x00000040, /* 1 = Interdomain trust account */
30 ACB_WSTRUST
= 0x00000080, /* 1 = Workstation trust account */
31 ACB_SVRTRUST
= 0x00000100, /* 1 = Server trust account */
32 ACB_PWNOEXP
= 0x00000200, /* 1 = User password does not expire */
33 ACB_AUTOLOCK
= 0x00000400, /* 1 = Account auto locked */
34 ACB_ENC_TXT_PWD_ALLOWED
= 0x00000800, /* 1 = Encryped text password is allowed */
35 ACB_SMARTCARD_REQUIRED
= 0x00001000, /* 1 = Smart Card required */
36 ACB_TRUSTED_FOR_DELEGATION
= 0x00002000, /* 1 = Trusted for Delegation */
37 ACB_NOT_DELEGATED
= 0x00004000, /* 1 = Not delegated */
38 ACB_USE_DES_KEY_ONLY
= 0x00008000, /* 1 = Use DES key only */
39 ACB_DONT_REQUIRE_PREAUTH
= 0x00010000, /* 1 = Preauth not required */
40 ACB_PW_EXPIRED
= 0x00020000, /* 1 = Password Expired */
41 ACB_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION
= 0x00040000,
42 ACB_NO_AUTH_DATA_REQD
= 0x00080000, /* 1 = No authorization data required */
43 ACB_PARTIAL_SECRETS_ACCOUNT
= 0x00100000,
44 ACB_USE_AES_KEYS
= 0x00200000
47 /* SAM server specific access rights */
49 typedef [bitmap32bit
] bitmap
{
50 SAMR_ACCESS_CONNECT_TO_SERVER
= 0x00000001,
51 SAMR_ACCESS_SHUTDOWN_SERVER
= 0x00000002,
52 SAMR_ACCESS_INITIALIZE_SERVER
= 0x00000004,
53 SAMR_ACCESS_CREATE_DOMAIN
= 0x00000008,
54 SAMR_ACCESS_ENUM_DOMAINS
= 0x00000010,
55 SAMR_ACCESS_LOOKUP_DOMAIN
= 0x00000020
56 } samr_ConnectAccessMask
;
58 const int SAMR_ACCESS_ALL_ACCESS
= 0x0000003F;
60 const int GENERIC_RIGHTS_SAM_ALL_ACCESS
=
61 (STANDARD_RIGHTS_REQUIRED_ACCESS |
62 SAMR_ACCESS_ALL_ACCESS
);
64 const int GENERIC_RIGHTS_SAM_READ
=
65 (STANDARD_RIGHTS_READ_ACCESS |
66 SAMR_ACCESS_ENUM_DOMAINS
);
68 const int GENERIC_RIGHTS_SAM_WRITE
=
69 (STANDARD_RIGHTS_WRITE_ACCESS |
70 SAMR_ACCESS_CREATE_DOMAIN |
71 SAMR_ACCESS_INITIALIZE_SERVER |
72 SAMR_ACCESS_SHUTDOWN_SERVER
);
74 const int GENERIC_RIGHTS_SAM_EXECUTE
=
75 (STANDARD_RIGHTS_EXECUTE_ACCESS |
76 SAMR_ACCESS_LOOKUP_DOMAIN |
77 SAMR_ACCESS_CONNECT_TO_SERVER
);
79 /* User Object specific access rights */
81 typedef [bitmap32bit
] bitmap
{
82 SAMR_USER_ACCESS_GET_NAME_ETC
= 0x00000001,
83 SAMR_USER_ACCESS_GET_LOCALE
= 0x00000002,
84 SAMR_USER_ACCESS_SET_LOC_COM
= 0x00000004,
85 SAMR_USER_ACCESS_GET_LOGONINFO
= 0x00000008,
86 SAMR_USER_ACCESS_GET_ATTRIBUTES
= 0x00000010,
87 SAMR_USER_ACCESS_SET_ATTRIBUTES
= 0x00000020,
88 SAMR_USER_ACCESS_CHANGE_PASSWORD
= 0x00000040,
89 SAMR_USER_ACCESS_SET_PASSWORD
= 0x00000080,
90 SAMR_USER_ACCESS_GET_GROUPS
= 0x00000100,
91 SAMR_USER_ACCESS_GET_GROUP_MEMBERSHIP
= 0x00000200,
92 SAMR_USER_ACCESS_CHANGE_GROUP_MEMBERSHIP
= 0x00000400
93 } samr_UserAccessMask
;
95 const int SAMR_USER_ACCESS_ALL_ACCESS
= 0x000007FF;
97 const int GENERIC_RIGHTS_USER_ALL_ACCESS
=
98 (STANDARD_RIGHTS_REQUIRED_ACCESS |
99 SAMR_USER_ACCESS_ALL_ACCESS
); /* 0x000f07ff */
101 const int GENERIC_RIGHTS_USER_READ
=
102 (STANDARD_RIGHTS_READ_ACCESS |
103 SAMR_USER_ACCESS_GET_GROUP_MEMBERSHIP |
104 SAMR_USER_ACCESS_GET_GROUPS |
105 SAMR_USER_ACCESS_GET_ATTRIBUTES |
106 SAMR_USER_ACCESS_GET_LOGONINFO |
107 SAMR_USER_ACCESS_GET_LOCALE
); /* 0x0002031a */
109 const int GENERIC_RIGHTS_USER_WRITE
=
110 (STANDARD_RIGHTS_WRITE_ACCESS |
111 SAMR_USER_ACCESS_CHANGE_PASSWORD |
112 SAMR_USER_ACCESS_SET_LOC_COM |
113 SAMR_USER_ACCESS_SET_ATTRIBUTES |
114 SAMR_USER_ACCESS_SET_PASSWORD |
115 SAMR_USER_ACCESS_CHANGE_GROUP_MEMBERSHIP
); /* 0x000204e4 */
117 const int GENERIC_RIGHTS_USER_EXECUTE
=
118 (STANDARD_RIGHTS_EXECUTE_ACCESS |
119 SAMR_USER_ACCESS_CHANGE_PASSWORD |
120 SAMR_USER_ACCESS_GET_NAME_ETC
); /* 0x00020041 */
122 /* Domain Object specific access rights */
124 typedef [bitmap32bit
] bitmap
{
125 SAMR_DOMAIN_ACCESS_LOOKUP_INFO_1
= 0x00000001,
126 SAMR_DOMAIN_ACCESS_SET_INFO_1
= 0x00000002,
127 SAMR_DOMAIN_ACCESS_LOOKUP_INFO_2
= 0x00000004,
128 SAMR_DOMAIN_ACCESS_SET_INFO_2
= 0x00000008,
129 SAMR_DOMAIN_ACCESS_CREATE_USER
= 0x00000010,
130 SAMR_DOMAIN_ACCESS_CREATE_GROUP
= 0x00000020,
131 SAMR_DOMAIN_ACCESS_CREATE_ALIAS
= 0x00000040,
132 SAMR_DOMAIN_ACCESS_LOOKUP_ALIAS
= 0x00000080,
133 SAMR_DOMAIN_ACCESS_ENUM_ACCOUNTS
= 0x00000100,
134 SAMR_DOMAIN_ACCESS_OPEN_ACCOUNT
= 0x00000200,
135 SAMR_DOMAIN_ACCESS_SET_INFO_3
= 0x00000400
136 } samr_DomainAccessMask
;
138 const int SAMR_DOMAIN_ACCESS_ALL_ACCESS
= 0x000007FF;
140 const int GENERIC_RIGHTS_DOMAIN_ALL_ACCESS
=
141 (STANDARD_RIGHTS_REQUIRED_ACCESS |
142 SAMR_DOMAIN_ACCESS_ALL_ACCESS
);
144 const int GENERIC_RIGHTS_DOMAIN_READ
=
145 (STANDARD_RIGHTS_READ_ACCESS |
146 SAMR_DOMAIN_ACCESS_LOOKUP_ALIAS |
147 SAMR_DOMAIN_ACCESS_LOOKUP_INFO_2
);
149 const int GENERIC_RIGHTS_DOMAIN_WRITE
=
150 (STANDARD_RIGHTS_WRITE_ACCESS |
151 SAMR_DOMAIN_ACCESS_SET_INFO_3 |
152 SAMR_DOMAIN_ACCESS_CREATE_ALIAS |
153 SAMR_DOMAIN_ACCESS_CREATE_GROUP |
154 SAMR_DOMAIN_ACCESS_CREATE_USER |
155 SAMR_DOMAIN_ACCESS_SET_INFO_2 |
156 SAMR_DOMAIN_ACCESS_SET_INFO_1
);
158 const int GENERIC_RIGHTS_DOMAIN_EXECUTE
=
159 (STANDARD_RIGHTS_EXECUTE_ACCESS |
160 SAMR_DOMAIN_ACCESS_OPEN_ACCOUNT |
161 SAMR_DOMAIN_ACCESS_ENUM_ACCOUNTS |
162 SAMR_DOMAIN_ACCESS_LOOKUP_INFO_1
);
164 /* Group Object specific access rights */
166 typedef [bitmap32bit
] bitmap
{
167 SAMR_GROUP_ACCESS_LOOKUP_INFO
= 0x00000001,
168 SAMR_GROUP_ACCESS_SET_INFO
= 0x00000002,
169 SAMR_GROUP_ACCESS_ADD_MEMBER
= 0x00000004,
170 SAMR_GROUP_ACCESS_REMOVE_MEMBER
= 0x00000008,
171 SAMR_GROUP_ACCESS_GET_MEMBERS
= 0x00000010
172 } samr_GroupAccessMask
;
174 const int SAMR_GROUP_ACCESS_ALL_ACCESS
= 0x0000001F;
176 const int GENERIC_RIGHTS_GROUP_ALL_ACCESS
=
177 (STANDARD_RIGHTS_REQUIRED_ACCESS |
178 SAMR_GROUP_ACCESS_ALL_ACCESS
); /* 0x000f001f */
180 const int GENERIC_RIGHTS_GROUP_READ
=
181 (STANDARD_RIGHTS_READ_ACCESS |
182 SAMR_GROUP_ACCESS_GET_MEMBERS
); /* 0x00020010 */
184 const int GENERIC_RIGHTS_GROUP_WRITE
=
185 (STANDARD_RIGHTS_WRITE_ACCESS |
186 SAMR_GROUP_ACCESS_REMOVE_MEMBER |
187 SAMR_GROUP_ACCESS_ADD_MEMBER |
188 SAMR_GROUP_ACCESS_SET_INFO
); /* 0x0002000e */
190 const int GENERIC_RIGHTS_GROUP_EXECUTE
=
191 (STANDARD_RIGHTS_EXECUTE_ACCESS |
192 SAMR_GROUP_ACCESS_LOOKUP_INFO
); /* 0x00020001 */
194 /* Alias Object specific access rights */
196 typedef [bitmap32bit
] bitmap
{
197 SAMR_ALIAS_ACCESS_ADD_MEMBER
= 0x00000001,
198 SAMR_ALIAS_ACCESS_REMOVE_MEMBER
= 0x00000002,
199 SAMR_ALIAS_ACCESS_GET_MEMBERS
= 0x00000004,
200 SAMR_ALIAS_ACCESS_LOOKUP_INFO
= 0x00000008,
201 SAMR_ALIAS_ACCESS_SET_INFO
= 0x00000010
202 } samr_AliasAccessMask
;
204 const int SAMR_ALIAS_ACCESS_ALL_ACCESS
= 0x0000001F;
206 const int GENERIC_RIGHTS_ALIAS_ALL_ACCESS
=
207 (STANDARD_RIGHTS_REQUIRED_ACCESS |
208 SAMR_ALIAS_ACCESS_ALL_ACCESS
); /* 0x000f001f */
210 const int GENERIC_RIGHTS_ALIAS_READ
=
211 (STANDARD_RIGHTS_READ_ACCESS |
212 SAMR_ALIAS_ACCESS_GET_MEMBERS
); /* 0x00020004 */
214 const int GENERIC_RIGHTS_ALIAS_WRITE
=
215 (STANDARD_RIGHTS_WRITE_ACCESS |
216 SAMR_ALIAS_ACCESS_REMOVE_MEMBER |
217 SAMR_ALIAS_ACCESS_ADD_MEMBER |
218 SAMR_ALIAS_ACCESS_SET_INFO
); /* 0x00020013 */
220 const int GENERIC_RIGHTS_ALIAS_EXECUTE
=
221 (STANDARD_RIGHTS_EXECUTE_ACCESS |
222 SAMR_ALIAS_ACCESS_LOOKUP_INFO
); /* 0x00020008 */
226 NTSTATUS samr_Connect
(
227 /* notice the lack of [string] */
228 [in,unique] uint16
*system_name
,
229 [in] samr_ConnectAccessMask access_mask
,
230 [out,ref] policy_handle
*connect_handle
236 [public] NTSTATUS samr_Close
(
237 [in,out,ref] policy_handle
*handle
243 NTSTATUS samr_SetSecurity
(
244 [in,ref] policy_handle
*handle,
245 [in] security_secinfo sec_info
,
246 [in,ref] sec_desc_buf
*sdbuf
252 NTSTATUS samr_QuerySecurity
(
253 [in,ref] policy_handle
*handle,
254 [in] security_secinfo sec_info
,
255 [out,ref] sec_desc_buf
**sdbuf
262 shutdown the SAM - once you call this the SAM will be dead
264 NTSTATUS samr_Shutdown
(
265 [in,ref] policy_handle
*connect_handle
270 NTSTATUS samr_LookupDomain
(
271 [in,ref] policy_handle
*connect_handle
,
272 [in,ref] lsa_String
*domain_name
,
273 [out,ref] dom_sid2
**sid
287 [size_is(count
)] samr_SamEntry
*entries
;
290 NTSTATUS samr_EnumDomains
(
291 [in,ref] policy_handle
*connect_handle
,
292 [in,out,ref] uint32
*resume_handle
,
293 [out,ref] samr_SamArray
**sam
,
294 [in] uint32 buf_size
,
295 [out,ref] uint32
*num_entries
299 /************************/
301 [public] NTSTATUS samr_OpenDomain
(
302 [in,ref] policy_handle
*connect_handle
,
303 [in] samr_DomainAccessMask access_mask
,
304 [in,ref] dom_sid2
*sid
,
305 [out,ref] policy_handle
*domain_handle
308 /************************/
312 DomainPasswordInformation
= 1,
313 DomainGeneralInformation
= 2,
314 DomainLogoffInformation
= 3,
315 DomainOemInformation
= 4,
316 DomainNameInformation
= 5,
317 DomainReplicationInformation
= 6,
318 DomainServerRoleInformation
= 7,
319 DomainModifiedInformation
= 8,
320 DomainStateInformation
= 9,
321 DomainUasInformation
= 10,
322 DomainGeneralInformation2
= 11,
323 DomainLockoutInformation
= 12,
324 DomainModifiedInformation2
= 13
325 } samr_DomainInfoClass
;
328 typedef [v1_enum] enum {
329 SAMR_ROLE_STANDALONE
= 0,
330 SAMR_ROLE_DOMAIN_MEMBER
= 1,
331 SAMR_ROLE_DOMAIN_BDC
= 2,
332 SAMR_ROLE_DOMAIN_PDC
= 3
335 /* password properties flags */
336 typedef [public,bitmap32bit
] bitmap
{
337 DOMAIN_PASSWORD_COMPLEX
= 0x00000001,
338 DOMAIN_PASSWORD_NO_ANON_CHANGE
= 0x00000002,
339 DOMAIN_PASSWORD_NO_CLEAR_CHANGE
= 0x00000004,
340 DOMAIN_PASSWORD_LOCKOUT_ADMINS
= 0x00000008,
341 DOMAIN_PASSWORD_STORE_CLEARTEXT
= 0x00000010,
342 DOMAIN_REFUSE_PASSWORD_CHANGE
= 0x00000020
343 } samr_PasswordProperties
;
345 typedef [v1_enum] enum {
346 DOMAIN_SERVER_ENABLED
= 1,
347 DOMAIN_SERVER_DISABLED
= 2
348 } samr_DomainServerState
;
351 uint16 min_password_length
;
352 uint16 password_history_length
;
353 samr_PasswordProperties password_properties
;
354 /* yes, these are signed. They are in negative 100ns */
355 dlong max_password_age
;
356 dlong min_password_age
;
360 NTTIME force_logoff_time
;
361 lsa_String oem_information
; /* comment */
362 lsa_String domain_name
;
363 lsa_String primary
; /* PDC name if this is a BDC */
365 samr_DomainServerState domain_server_state
;
371 } samr_DomGeneralInformation
;
374 NTTIME force_logoff_time
;
378 lsa_String oem_information
; /* comment */
379 } samr_DomOEMInformation
;
382 lsa_String domain_name
;
395 NTTIME domain_create_time
;
399 samr_DomainServerState domain_server_state
;
403 samr_DomGeneralInformation general
;
404 hyper lockout_duration
;
405 hyper lockout_window
;
406 uint16 lockout_threshold
;
407 } samr_DomGeneralInformation2
;
410 hyper lockout_duration
;
411 hyper lockout_window
;
412 uint16 lockout_threshold
;
417 NTTIME domain_create_time
;
418 hyper modified_count_at_last_promotion
;
421 typedef [switch_type(uint16
)] union {
422 [case(1)] samr_DomInfo1 info1
;
423 [case(2)] samr_DomGeneralInformation general
;
424 [case(3)] samr_DomInfo3 info3
;
425 [case(4)] samr_DomOEMInformation oem
;
426 [case(5)] samr_DomInfo5 info5
;
427 [case(6)] samr_DomInfo6 info6
;
428 [case(7)] samr_DomInfo7 info7
;
429 [case(8)] samr_DomInfo8 info8
;
430 [case(9)] samr_DomInfo9 info9
;
431 [case(11)] samr_DomGeneralInformation2 general2
;
432 [case(12)] samr_DomInfo12 info12
;
433 [case(13)] samr_DomInfo13 info13
;
436 NTSTATUS samr_QueryDomainInfo
(
437 [in,ref] policy_handle
*domain_handle
,
438 [in] samr_DomainInfoClass level
,
439 [out,ref,switch_is(level
)] samr_DomainInfo
**info
442 /************************/
445 only levels 1, 3, 4, 6, 7, 9, 12 are valid for this
448 NTSTATUS samr_SetDomainInfo
(
449 [in,ref] policy_handle
*domain_handle
,
450 [in] samr_DomainInfoClass level
,
451 [in,switch_is(level
),ref] samr_DomainInfo
*info
455 /************************/
457 NTSTATUS samr_CreateDomainGroup
(
458 [in,ref] policy_handle
*domain_handle
,
459 [in,ref] lsa_String
*name
,
460 [in] samr_GroupAccessMask access_mask
,
461 [out,ref] policy_handle
*group_handle
,
462 [out,ref] uint32
*rid
466 /************************/
468 NTSTATUS samr_EnumDomainGroups
(
469 [in] policy_handle
*domain_handle
,
470 [in,out,ref] uint32
*resume_handle
,
471 [out,ref] samr_SamArray
**sam
,
472 [in] uint32 max_size
,
473 [out,ref] uint32
*num_entries
476 /************************/
478 NTSTATUS samr_CreateUser
(
479 [in,ref] policy_handle
*domain_handle
,
480 [in,ref] lsa_String
*account_name
,
481 [in] samr_UserAccessMask access_mask
,
482 [out,ref] policy_handle
*user_handle
,
483 [out,ref] uint32
*rid
486 /************************/
490 /* w2k3 treats max_size as max_users*54 and sets the
491 resume_handle as the rid of the last user sent
493 const int SAMR_ENUM_USERS_MULTIPLIER
= 54;
495 NTSTATUS samr_EnumDomainUsers
(
496 [in] policy_handle
*domain_handle
,
497 [in,out,ref] uint32
*resume_handle
,
498 [in] samr_AcctFlags acct_flags
,
499 [out,ref] samr_SamArray
**sam
,
500 [in] uint32 max_size
,
501 [out,ref] uint32
*num_entries
504 /************************/
506 NTSTATUS samr_CreateDomAlias
(
507 [in,ref] policy_handle
*domain_handle
,
508 [in,ref] lsa_String
*alias_name
,
509 [in] samr_AliasAccessMask access_mask
,
510 [out,ref] policy_handle
*alias_handle
,
511 [out,ref] uint32
*rid
514 /************************/
516 NTSTATUS samr_EnumDomainAliases
(
517 [in] policy_handle
*domain_handle
,
518 [in,out,ref] uint32
*resume_handle
,
519 [out,ref] samr_SamArray
**sam
,
520 [in] uint32 max_size
,
521 [out,ref] uint32
*num_entries
524 /************************/
528 [range(0,1024)] uint32 count
;
529 [size_is(count
)] uint32
*ids
;
532 NTSTATUS samr_GetAliasMembership
(
533 [in,ref] policy_handle
*domain_handle
,
534 [in,ref] lsa_SidArray
*sids
,
535 [out,ref] samr_Ids
*rids
538 /************************/
541 [public] NTSTATUS samr_LookupNames
(
542 [in,ref] policy_handle
*domain_handle
,
543 [in,range(0,1000)] uint32 num_names
,
544 [in,size_is(1000),length_is(num_names
)] lsa_String names
[],
545 [out,ref] samr_Ids
*rids
,
546 [out,ref] samr_Ids
*types
550 /************************/
552 NTSTATUS samr_LookupRids
(
553 [in,ref] policy_handle
*domain_handle
,
554 [in,range(0,1000)] uint32 num_rids
,
555 [in,size_is(1000),length_is(num_rids
)] uint32 rids
[],
556 [out,ref] lsa_Strings
*names
,
557 [out,ref] samr_Ids
*types
560 /************************/
562 NTSTATUS samr_OpenGroup
(
563 [in,ref] policy_handle
*domain_handle
,
564 [in] samr_GroupAccessMask access_mask
,
566 [out,ref] policy_handle
*group_handle
569 /************************/
574 security_GroupAttrs attributes
;
576 lsa_String description
;
580 security_GroupAttrs attributes
;
581 } samr_GroupInfoAttributes
;
584 lsa_String description
;
585 } samr_GroupInfoDescription
;
590 GROUPINFOATTRIBUTES
= 3,
591 GROUPINFODESCRIPTION
= 4,
593 } samr_GroupInfoEnum
;
595 typedef [switch_type(samr_GroupInfoEnum
)] union {
596 [case(GROUPINFOALL
)] samr_GroupInfoAll all
;
597 [case(GROUPINFONAME
)] lsa_String name
;
598 [case(GROUPINFOATTRIBUTES
)] samr_GroupInfoAttributes attributes
;
599 [case(GROUPINFODESCRIPTION
)] lsa_String description
;
600 [case(GROUPINFOALL2
)] samr_GroupInfoAll all2
;
603 NTSTATUS samr_QueryGroupInfo
(
604 [in,ref] policy_handle
*group_handle
,
605 [in] samr_GroupInfoEnum level
,
606 [out,ref,switch_is(level
)] samr_GroupInfo
**info
609 /************************/
611 NTSTATUS samr_SetGroupInfo
(
612 [in,ref] policy_handle
*group_handle
,
613 [in] samr_GroupInfoEnum level
,
614 [in,switch_is(level
),ref] samr_GroupInfo
*info
617 /************************/
619 NTSTATUS samr_AddGroupMember
(
620 [in,ref] policy_handle
*group_handle
,
625 /************************/
627 NTSTATUS samr_DeleteDomainGroup
(
628 [in,out,ref] policy_handle
*group_handle
631 /************************/
633 NTSTATUS samr_DeleteGroupMember
(
634 [in,ref] policy_handle
*group_handle
,
639 /************************/
643 [size_is(count
)] uint32
*rids
;
644 [size_is(count
)] security_GroupAttrs
*attributes
;
647 NTSTATUS samr_QueryGroupMember
(
648 [in,ref] policy_handle
*group_handle
,
649 [out,ref] samr_RidAttrArray
**rids
653 /************************/
657 win2003 seems to accept any data at all for the two integers
658 below, and doesn't seem to do anything with them that I can
659 see. Weird. I really expected the first integer to be a rid
660 and the second to be the attributes for that rid member.
662 NTSTATUS samr_SetMemberAttributesOfGroup
(
663 [in,ref] policy_handle
*group_handle
,
664 [in] uint32 unknown1
,
669 /************************/
671 NTSTATUS samr_OpenAlias
(
672 [in,ref] policy_handle
*domain_handle
,
673 [in] samr_AliasAccessMask access_mask
,
675 [out,ref] policy_handle
*alias_handle
679 /************************/
685 lsa_String description
;
691 ALIASINFODESCRIPTION
= 3
692 } samr_AliasInfoEnum
;
694 typedef [switch_type(samr_AliasInfoEnum
)] union {
695 [case(ALIASINFOALL
)] samr_AliasInfoAll all
;
696 [case(ALIASINFONAME
)] lsa_String name
;
697 [case(ALIASINFODESCRIPTION
)] lsa_String description
;
700 NTSTATUS samr_QueryAliasInfo
(
701 [in,ref] policy_handle
*alias_handle
,
702 [in] samr_AliasInfoEnum level
,
703 [out,ref,switch_is(level
)] samr_AliasInfo
**info
706 /************************/
708 NTSTATUS samr_SetAliasInfo
(
709 [in,ref] policy_handle
*alias_handle
,
710 [in] samr_AliasInfoEnum level
,
711 [in,switch_is(level
),ref] samr_AliasInfo
*info
714 /************************/
716 NTSTATUS samr_DeleteDomAlias
(
717 [in,out,ref] policy_handle
*alias_handle
720 /************************/
722 NTSTATUS samr_AddAliasMember
(
723 [in,ref] policy_handle
*alias_handle
,
724 [in,ref] dom_sid2
*sid
727 /************************/
729 NTSTATUS samr_DeleteAliasMember
(
730 [in,ref] policy_handle
*alias_handle
,
731 [in,ref] dom_sid2
*sid
734 /************************/
736 NTSTATUS samr_GetMembersInAlias
(
737 [in,ref] policy_handle
*alias_handle
,
738 [out,ref] lsa_SidArray
*sids
741 /************************/
743 [public] NTSTATUS samr_OpenUser
(
744 [in,ref] policy_handle
*domain_handle
,
745 [in] samr_UserAccessMask access_mask
,
747 [out,ref] policy_handle
*user_handle
750 /************************/
752 NTSTATUS samr_DeleteUser
(
753 [in,out,ref] policy_handle
*user_handle
756 /************************/
760 UserGeneralInformation
= 1,
761 UserPreferencesInformation
= 2,
762 UserLogonInformation
= 3,
763 UserLogonHoursInformation
= 4,
764 UserAccountInformation
= 5,
765 UserNameInformation
= 6,
766 UserAccountNameInformation
= 7,
767 UserFullNameInformation
= 8,
768 UserPrimaryGroupInformation
= 9,
769 UserHomeInformation
= 10,
770 UserScriptInformation
= 11,
771 UserProfileInformation
= 12,
772 UserAdminCommentInformation
= 13,
773 UserWorkStationsInformation
= 14,
774 UserControlInformation
= 16,
775 UserExpiresInformation
= 17,
776 UserInternal1Information
= 18,
777 UserParametersInformation
= 20,
778 UserAllInformation
= 21,
779 UserInternal4Information
= 23,
780 UserInternal5Information
= 24,
781 UserInternal4InformationNew
= 25,
782 UserInternal5InformationNew
= 26
783 } samr_UserInfoLevel
;
786 lsa_String account_name
;
787 lsa_String full_name
;
789 lsa_String description
;
795 lsa_String reserved
; /* settable, but doesn't stick. probably obsolete */
800 /* this is also used in samr and netlogon */
801 typedef [public, flag
(NDR_PAHEX
)] struct {
802 uint16 units_per_week
;
803 [size_is(1260), length_is(units_per_week
/8)] uint8
*bits
;
807 lsa_String account_name
;
808 lsa_String full_name
;
811 lsa_String home_directory
;
812 lsa_String home_drive
;
813 lsa_String logon_script
;
814 lsa_String profile_path
;
815 lsa_String workstations
;
818 NTTIME last_password_change
;
819 NTTIME allow_password_change
;
820 NTTIME force_password_change
;
821 samr_LogonHours logon_hours
;
822 uint16 bad_password_count
;
824 samr_AcctFlags acct_flags
;
828 samr_LogonHours logon_hours
;
832 lsa_String account_name
;
833 lsa_String full_name
;
836 lsa_String home_directory
;
837 lsa_String home_drive
;
838 lsa_String logon_script
;
839 lsa_String profile_path
;
840 lsa_String description
;
841 lsa_String workstations
;
844 samr_LogonHours logon_hours
;
845 uint16 bad_password_count
;
847 NTTIME last_password_change
;
849 samr_AcctFlags acct_flags
;
853 lsa_String account_name
;
854 lsa_String full_name
;
858 lsa_String account_name
;
862 lsa_String full_name
;
870 lsa_String home_directory
;
871 lsa_String home_drive
;
875 lsa_String logon_script
;
879 lsa_String profile_path
;
883 lsa_String description
;
887 lsa_String workstations
;
891 samr_AcctFlags acct_flags
;
898 typedef [public, flag
(NDR_PAHEX
)] struct {
903 samr_Password nt_pwd
;
904 samr_Password lm_pwd
;
905 boolean8 nt_pwd_active
;
906 boolean8 lm_pwd_active
;
907 uint8 password_expired
;
911 lsa_BinaryString parameters
;
914 /* this defines the bits used for fields_present in info21 */
915 typedef [bitmap32bit
] bitmap
{
916 SAMR_FIELD_ACCOUNT_NAME
= 0x00000001,
917 SAMR_FIELD_FULL_NAME
= 0x00000002,
918 SAMR_FIELD_RID
= 0x00000004,
919 SAMR_FIELD_PRIMARY_GID
= 0x00000008,
920 SAMR_FIELD_DESCRIPTION
= 0x00000010,
921 SAMR_FIELD_COMMENT
= 0x00000020,
922 SAMR_FIELD_HOME_DIRECTORY
= 0x00000040,
923 SAMR_FIELD_HOME_DRIVE
= 0x00000080,
924 SAMR_FIELD_LOGON_SCRIPT
= 0x00000100,
925 SAMR_FIELD_PROFILE_PATH
= 0x00000200,
926 SAMR_FIELD_WORKSTATIONS
= 0x00000400,
927 SAMR_FIELD_LAST_LOGON
= 0x00000800,
928 SAMR_FIELD_LAST_LOGOFF
= 0x00001000,
929 SAMR_FIELD_LOGON_HOURS
= 0x00002000,
930 SAMR_FIELD_BAD_PWD_COUNT
= 0x00004000,
931 SAMR_FIELD_NUM_LOGONS
= 0x00008000,
932 SAMR_FIELD_ALLOW_PWD_CHANGE
= 0x00010000,
933 SAMR_FIELD_FORCE_PWD_CHANGE
= 0x00020000,
934 SAMR_FIELD_LAST_PWD_CHANGE
= 0x00040000,
935 SAMR_FIELD_ACCT_EXPIRY
= 0x00080000,
936 SAMR_FIELD_ACCT_FLAGS
= 0x00100000,
937 SAMR_FIELD_PARAMETERS
= 0x00200000,
938 SAMR_FIELD_COUNTRY_CODE
= 0x00400000,
939 SAMR_FIELD_CODE_PAGE
= 0x00800000,
940 SAMR_FIELD_NT_PASSWORD_PRESENT
= 0x01000000, /* either of these */
941 SAMR_FIELD_LM_PASSWORD_PRESENT
= 0x02000000, /* two bits seems to work */
942 SAMR_FIELD_PRIVATE_DATA
= 0x04000000,
943 SAMR_FIELD_EXPIRED_FLAG
= 0x08000000,
944 SAMR_FIELD_SEC_DESC
= 0x10000000,
945 SAMR_FIELD_OWF_PWD
= 0x20000000
946 } samr_FieldsPresent
;
948 /* used for 'password_expired' in samr_UserInfo21 */
949 const int PASS_MUST_CHANGE_AT_NEXT_LOGON
= 0x01;
950 const int PASS_DONT_CHANGE_AT_NEXT_LOGON
= 0x00;
955 NTTIME last_password_change
;
957 NTTIME allow_password_change
;
958 NTTIME force_password_change
;
959 lsa_String account_name
;
960 lsa_String full_name
;
961 lsa_String home_directory
;
962 lsa_String home_drive
;
963 lsa_String logon_script
;
964 lsa_String profile_path
;
965 lsa_String description
;
966 lsa_String workstations
;
968 lsa_BinaryString parameters
;
969 lsa_BinaryString lm_owf_password
;
970 lsa_BinaryString nt_owf_password
;
971 lsa_String private_data
;
973 [size_is(buf_count
)] uint8
*buffer
;
976 samr_AcctFlags acct_flags
;
977 samr_FieldsPresent fields_present
;
978 samr_LogonHours logon_hours
;
979 uint16 bad_password_count
;
983 uint8 lm_password_set
;
984 uint8 nt_password_set
;
985 uint8 password_expired
;
986 uint8 private_data_sensitive
;
989 typedef [public, flag
(NDR_PAHEX
)] struct {
991 } samr_CryptPassword
;
994 samr_UserInfo21 info
;
995 samr_CryptPassword password
;
999 samr_CryptPassword password
;
1000 uint8 password_expired
;
1003 typedef [flag
(NDR_PAHEX
)] struct {
1005 } samr_CryptPasswordEx
;
1008 samr_UserInfo21 info
;
1009 samr_CryptPasswordEx password
;
1013 samr_CryptPasswordEx password
;
1014 uint8 password_expired
;
1017 typedef [switch_type(uint16
)] union {
1018 [case(1)] samr_UserInfo1 info1
;
1019 [case(2)] samr_UserInfo2 info2
;
1020 [case(3)] samr_UserInfo3 info3
;
1021 [case(4)] samr_UserInfo4 info4
;
1022 [case(5)] samr_UserInfo5 info5
;
1023 [case(6)] samr_UserInfo6 info6
;
1024 [case(7)] samr_UserInfo7 info7
;
1025 [case(8)] samr_UserInfo8 info8
;
1026 [case(9)] samr_UserInfo9 info9
;
1027 [case(10)] samr_UserInfo10 info10
;
1028 [case(11)] samr_UserInfo11 info11
;
1029 [case(12)] samr_UserInfo12 info12
;
1030 [case(13)] samr_UserInfo13 info13
;
1031 [case(14)] samr_UserInfo14 info14
;
1032 [case(16)] samr_UserInfo16 info16
;
1033 [case(17)] samr_UserInfo17 info17
;
1034 [case(18)] samr_UserInfo18 info18
;
1035 [case(20)] samr_UserInfo20 info20
;
1036 [case(21)] samr_UserInfo21 info21
;
1037 [case(23)] samr_UserInfo23 info23
;
1038 [case(24)] samr_UserInfo24 info24
;
1039 [case(25)] samr_UserInfo25 info25
;
1040 [case(26)] samr_UserInfo26 info26
;
1043 [public] NTSTATUS samr_QueryUserInfo
(
1044 [in,ref] policy_handle
*user_handle
,
1045 [in] samr_UserInfoLevel level
,
1046 [out,ref,switch_is(level
)] samr_UserInfo
**info
1050 /************************/
1052 [public] NTSTATUS samr_SetUserInfo
(
1053 [in,ref] policy_handle
*user_handle
,
1054 [in] samr_UserInfoLevel level
,
1055 [in,ref,switch_is(level
)] samr_UserInfo
*info
1058 /************************/
1061 this is a password change interface that doesn't give
1062 the server the plaintext password. Depricated.
1064 NTSTATUS samr_ChangePasswordUser
(
1065 [in,ref] policy_handle
*user_handle
,
1066 [in] boolean8 lm_present
,
1067 [in,unique] samr_Password
*old_lm_crypted
,
1068 [in,unique] samr_Password
*new_lm_crypted
,
1069 [in] boolean8 nt_present
,
1070 [in,unique] samr_Password
*old_nt_crypted
,
1071 [in,unique] samr_Password
*new_nt_crypted
,
1072 [in] boolean8 cross1_present
,
1073 [in,unique] samr_Password
*nt_cross
,
1074 [in] boolean8 cross2_present
,
1075 [in,unique] samr_Password
*lm_cross
1078 /************************/
1081 typedef [public] struct {
1083 security_GroupAttrs attributes
;
1084 } samr_RidWithAttribute
;
1086 typedef [public] struct {
1088 [size_is(count
)] samr_RidWithAttribute
*rids
;
1089 } samr_RidWithAttributeArray
;
1091 NTSTATUS samr_GetGroupsForUser
(
1092 [in,ref] policy_handle
*user_handle
,
1093 [out,ref] samr_RidWithAttributeArray
**rids
1096 /************************/
1102 samr_AcctFlags acct_flags
;
1103 lsa_String account_name
;
1104 lsa_String description
;
1105 lsa_String full_name
;
1106 } samr_DispEntryGeneral
;
1110 [size_is(count
)] samr_DispEntryGeneral
*entries
;
1111 } samr_DispInfoGeneral
;
1116 samr_AcctFlags acct_flags
;
1117 lsa_String account_name
;
1118 lsa_String description
;
1119 } samr_DispEntryFull
;
1123 [size_is(count
)] samr_DispEntryFull
*entries
;
1124 } samr_DispInfoFull
;
1129 security_GroupAttrs acct_flags
;
1130 lsa_String account_name
;
1131 lsa_String description
;
1132 } samr_DispEntryFullGroup
;
1136 [size_is(count
)] samr_DispEntryFullGroup
*entries
;
1137 } samr_DispInfoFullGroups
;
1141 lsa_AsciiStringLarge account_name
;
1142 } samr_DispEntryAscii
;
1146 [size_is(count
)] samr_DispEntryAscii
*entries
;
1147 } samr_DispInfoAscii
;
1149 typedef [switch_type(uint16
)] union {
1150 [case(1)] samr_DispInfoGeneral info1
;/* users */
1151 [case(2)] samr_DispInfoFull info2
; /* trust accounts? */
1152 [case(3)] samr_DispInfoFullGroups info3
; /* groups */
1153 [case(4)] samr_DispInfoAscii info4
; /* users */
1154 [case(5)] samr_DispInfoAscii info5
; /* groups */
1157 NTSTATUS samr_QueryDisplayInfo
(
1158 [in,ref] policy_handle
*domain_handle
,
1160 [in] uint32 start_idx
,
1161 [in] uint32 max_entries
,
1162 [in] uint32 buf_size
,
1163 [out,ref] uint32
*total_size
,
1164 [out,ref] uint32
*returned_size
,
1165 [out,ref,switch_is(level
)] samr_DispInfo
*info
1169 /************************/
1173 this seems to be an alphabetic search function. The returned index
1174 is the index for samr_QueryDisplayInfo needed to get names occurring
1175 after the specified name. The supplied name does not need to exist
1176 in the database (for example you can supply just a first letter for
1177 searching starting at that letter)
1179 The level corresponds to the samr_QueryDisplayInfo level
1181 NTSTATUS samr_GetDisplayEnumerationIndex
(
1182 [in,ref] policy_handle
*domain_handle
,
1184 [in,ref] lsa_String
*name
,
1185 [out,ref] uint32
*idx
1190 /************************/
1194 w2k3 returns NT_STATUS_NOT_IMPLEMENTED for this
1196 NTSTATUS samr_TestPrivateFunctionsDomain
(
1197 [in,ref] policy_handle
*domain_handle
1201 /************************/
1205 w2k3 returns NT_STATUS_NOT_IMPLEMENTED for this
1207 NTSTATUS samr_TestPrivateFunctionsUser
(
1208 [in,ref] policy_handle
*user_handle
1212 /************************/
1216 uint16 min_password_length
;
1217 samr_PasswordProperties password_properties
;
1220 [public] NTSTATUS samr_GetUserPwInfo
(
1221 [in,ref] policy_handle
*user_handle
,
1222 [out,ref] samr_PwInfo
*info
1225 /************************/
1227 NTSTATUS samr_RemoveMemberFromForeignDomain
(
1228 [in,ref] policy_handle
*domain_handle
,
1229 [in,ref] dom_sid2
*sid
1232 /************************/
1236 how is this different from QueryDomainInfo ??
1238 NTSTATUS samr_QueryDomainInfo2
(
1239 [in,ref] policy_handle
*domain_handle
,
1240 [in] samr_DomainInfoClass level
,
1241 [out,ref,switch_is(level
)] samr_DomainInfo
**info
1244 /************************/
1248 how is this different from QueryUserInfo ??
1250 NTSTATUS samr_QueryUserInfo2
(
1251 [in,ref] policy_handle
*user_handle
,
1252 [in] samr_UserInfoLevel level
,
1253 [out,ref,switch_is(level
)] samr_UserInfo
**info
1256 /************************/
1260 how is this different from QueryDisplayInfo??
1262 NTSTATUS samr_QueryDisplayInfo2
(
1263 [in,ref] policy_handle
*domain_handle
,
1265 [in] uint32 start_idx
,
1266 [in] uint32 max_entries
,
1267 [in] uint32 buf_size
,
1268 [out,ref] uint32
*total_size
,
1269 [out,ref] uint32
*returned_size
,
1270 [out,ref,switch_is(level
)] samr_DispInfo
*info
1273 /************************/
1277 how is this different from GetDisplayEnumerationIndex ??
1279 NTSTATUS samr_GetDisplayEnumerationIndex2
(
1280 [in,ref] policy_handle
*domain_handle
,
1282 [in,ref] lsa_String
*name
,
1283 [out,ref] uint32
*idx
1287 /************************/
1289 NTSTATUS samr_CreateUser2
(
1290 [in,ref] policy_handle
*domain_handle
,
1291 [in,ref] lsa_String
*account_name
,
1292 [in] samr_AcctFlags acct_flags
,
1293 [in] samr_UserAccessMask access_mask
,
1294 [out,ref] policy_handle
*user_handle
,
1295 [out,ref] uint32
*access_granted
,
1296 [out,ref] uint32
*rid
1300 /************************/
1304 another duplicate. There must be a reason ....
1306 NTSTATUS samr_QueryDisplayInfo3
(
1307 [in,ref] policy_handle
*domain_handle
,
1309 [in] uint32 start_idx
,
1310 [in] uint32 max_entries
,
1311 [in] uint32 buf_size
,
1312 [out,ref] uint32
*total_size
,
1313 [out,ref] uint32
*returned_size
,
1314 [out,ref,switch_is(level
)] samr_DispInfo
*info
1317 /************************/
1319 NTSTATUS samr_AddMultipleMembersToAlias
(
1320 [in,ref] policy_handle
*alias_handle
,
1321 [in,ref] lsa_SidArray
*sids
1324 /************************/
1326 NTSTATUS samr_RemoveMultipleMembersFromAlias
(
1327 [in,ref] policy_handle
*alias_handle
,
1328 [in,ref] lsa_SidArray
*sids
1331 /************************/
1334 NTSTATUS samr_OemChangePasswordUser2
(
1335 [in,unique] lsa_AsciiString
*server
,
1336 [in,ref] lsa_AsciiString
*account
,
1337 [in,unique] samr_CryptPassword
*password
,
1338 [in,unique] samr_Password
*hash
1341 /************************/
1343 NTSTATUS samr_ChangePasswordUser2
(
1344 [in,unique] lsa_String
*server
,
1345 [in,ref] lsa_String
*account
,
1346 [in,unique] samr_CryptPassword
*nt_password
,
1347 [in,unique] samr_Password
*nt_verifier
,
1348 [in] boolean8 lm_change
,
1349 [in,unique] samr_CryptPassword
*lm_password
,
1350 [in,unique] samr_Password
*lm_verifier
1353 /************************/
1355 NTSTATUS samr_GetDomPwInfo
(
1356 [in,unique] lsa_String
*domain_name
,
1357 [out,ref] samr_PwInfo
*info
1360 /************************/
1362 NTSTATUS samr_Connect2
(
1363 [in,unique,string,charset
(UTF16
)] uint16
*system_name
,
1364 [in] samr_ConnectAccessMask access_mask
,
1365 [out,ref] policy_handle
*connect_handle
1368 /************************/
1371 seems to be an exact alias for samr_SetUserInfo()
1373 [public] NTSTATUS samr_SetUserInfo2
(
1374 [in,ref] policy_handle
*user_handle
,
1375 [in] samr_UserInfoLevel level
,
1376 [in,ref,switch_is(level
)] samr_UserInfo
*info
1379 /************************/
1382 this one is mysterious. I have a few guesses, but nothing working yet
1384 NTSTATUS samr_SetBootKeyInformation
(
1385 [in,ref] policy_handle
*connect_handle
,
1386 [in] uint32 unknown1
,
1387 [in] uint32 unknown2
,
1388 [in] uint32 unknown3
1391 /************************/
1393 NTSTATUS samr_GetBootKeyInformation
(
1394 [in,ref] policy_handle
*domain_handle
,
1395 [out,ref] uint32
*unknown
1398 /************************/
1400 NTSTATUS samr_Connect3
(
1401 [in,unique,string,charset
(UTF16
)] uint16
*system_name
,
1402 /* this unknown value seems to be completely ignored by w2k3 */
1403 [in] uint32 unknown
,
1404 [in] samr_ConnectAccessMask access_mask
,
1405 [out,ref] policy_handle
*connect_handle
1408 /************************/
1411 typedef [v1_enum] enum {
1412 SAMR_CONNECT_PRE_W2K
= 1,
1413 SAMR_CONNECT_W2K
= 2,
1414 SAMR_CONNECT_AFTER_W2K
= 3
1415 } samr_ConnectVersion
;
1417 NTSTATUS samr_Connect4
(
1418 [in,unique,string,charset
(UTF16
)] uint16
*system_name
,
1419 [in] samr_ConnectVersion client_version
,
1420 [in] samr_ConnectAccessMask access_mask
,
1421 [out,ref] policy_handle
*connect_handle
1424 /************************/
1427 typedef [public,v1_enum] enum {
1428 SAM_PWD_CHANGE_NO_ERROR
= 0,
1429 SAM_PWD_CHANGE_PASSWORD_TOO_SHORT
= 1,
1430 SAM_PWD_CHANGE_PWD_IN_HISTORY
= 2,
1431 SAM_PWD_CHANGE_USERNAME_IN_PASSWORD
= 3,
1432 SAM_PWD_CHANGE_FULLNAME_IN_PASSWORD
= 4,
1433 SAM_PWD_CHANGE_NOT_COMPLEX
= 5,
1434 SAM_PWD_CHANGE_MACHINE_NOT_DEFAULT
= 6,
1435 SAM_PWD_CHANGE_FAILED_BY_FILTER
= 7,
1436 SAM_PWD_CHANGE_PASSWORD_TOO_LONG
= 8
1437 } samPwdChangeReason
;
1440 samPwdChangeReason extendedFailureReason
;
1441 lsa_String filterModuleName
;
1442 } userPwdChangeFailureInformation
;
1444 [public] NTSTATUS samr_ChangePasswordUser3
(
1445 [in,unique] lsa_String
*server
,
1446 [in,ref] lsa_String
*account
,
1447 [in,unique] samr_CryptPassword
*nt_password
,
1448 [in,unique] samr_Password
*nt_verifier
,
1449 [in] boolean8 lm_change
,
1450 [in,unique] samr_CryptPassword
*lm_password
,
1451 [in,unique] samr_Password
*lm_verifier
,
1452 [in,unique] samr_CryptPassword
*password3
,
1453 [out,ref] samr_DomInfo1
**dominfo
,
1454 [out,ref] userPwdChangeFailureInformation
**reject
1457 /************************/
1461 samr_ConnectVersion client_version
; /* w2k3 gives 3 */
1462 uint32 unknown2
; /* w2k3 gives 0 */
1463 } samr_ConnectInfo1
;
1466 [case(1)] samr_ConnectInfo1 info1
;
1469 [public] NTSTATUS samr_Connect5
(
1470 [in,unique,string,charset
(UTF16
)] uint16
*system_name
,
1471 [in] samr_ConnectAccessMask access_mask
,
1472 [in] uint32 level_in
,
1473 [in,ref,switch_is(level_in
)] samr_ConnectInfo
*info_in
,
1474 [out,ref] uint32
*level_out
,
1475 [out,ref,switch_is(*level_out
)] samr_ConnectInfo
*info_out
,
1476 [out,ref] policy_handle
*connect_handle
1479 /************************/
1481 NTSTATUS samr_RidToSid
(
1482 [in,ref] policy_handle
*domain_handle
,
1484 [out,ref] dom_sid2
**sid
1487 /************************/
1491 this should set the DSRM password for the server, which is used
1492 when booting into Directory Services Recovery Mode on a DC. Win2003
1493 gives me NT_STATUS_NOT_SUPPORTED
1496 NTSTATUS samr_SetDsrmPassword
(
1497 [in,unique] lsa_String
*name
,
1498 [in] uint32 unknown
,
1499 [in,unique] samr_Password
*hash
1503 /************************/
1505 /************************/
1506 typedef [bitmap32bit
] bitmap
{
1507 SAMR_VALIDATE_FIELD_PASSWORD_LAST_SET
= 0x00000001,
1508 SAMR_VALIDATE_FIELD_BAD_PASSWORD_TIME
= 0x00000002,
1509 SAMR_VALIDATE_FIELD_LOCKOUT_TIME
= 0x00000004,
1510 SAMR_VALIDATE_FIELD_BAD_PASSWORD_COUNT
= 0x00000008,
1511 SAMR_VALIDATE_FIELD_PASSWORD_HISTORY_LENGTH
= 0x00000010,
1512 SAMR_VALIDATE_FIELD_PASSWORD_HISTORY
= 0x00000020
1513 } samr_ValidateFieldsPresent
;
1516 NetValidateAuthentication
= 1,
1517 NetValidatePasswordChange
= 2,
1518 NetValidatePasswordReset
= 3
1519 } samr_ValidatePasswordLevel
;
1521 /* NetApi maps samr_ValidationStatus errors to WERRORs. Haven't
1522 * identified the mapping of
1523 * - NERR_PasswordFilterError
1524 * - NERR_PasswordExpired and
1525 * - NERR_PasswordCantChange
1530 SAMR_VALIDATION_STATUS_SUCCESS
= 0,
1531 SAMR_VALIDATION_STATUS_PASSWORD_MUST_CHANGE
= 1,
1532 SAMR_VALIDATION_STATUS_ACCOUNT_LOCKED_OUT
= 2,
1533 SAMR_VALIDATION_STATUS_PASSWORD_EXPIRED
= 3,
1534 SAMR_VALIDATION_STATUS_BAD_PASSWORD
= 4,
1535 SAMR_VALIDATION_STATUS_PWD_HISTORY_CONFLICT
= 5,
1536 SAMR_VALIDATION_STATUS_PWD_TOO_SHORT
= 6,
1537 SAMR_VALIDATION_STATUS_PWD_TOO_LONG
= 7,
1538 SAMR_VALIDATION_STATUS_NOT_COMPLEX_ENOUGH
= 8,
1539 SAMR_VALIDATION_STATUS_PASSWORD_TOO_RECENT
= 9,
1540 SAMR_VALIDATION_STATUS_PASSWORD_FILTER_ERROR
= 10
1541 } samr_ValidationStatus
;
1545 [size_is(length
)] uint8
*data
;
1546 } samr_ValidationBlob
;
1549 samr_ValidateFieldsPresent fields_present
;
1550 NTTIME_hyper last_password_change
;
1551 NTTIME_hyper bad_password_time
;
1552 NTTIME_hyper lockout_time
;
1553 uint32 bad_pwd_count
;
1554 uint32 pwd_history_len
;
1555 [size_is(pwd_history_len
)] samr_ValidationBlob
*pwd_history
;
1556 } samr_ValidatePasswordInfo
;
1559 samr_ValidatePasswordInfo info
;
1560 samr_ValidationStatus status
;
1561 } samr_ValidatePasswordRepCtr
;
1563 typedef [switch_type(uint16
)] union {
1564 [case(1)] samr_ValidatePasswordRepCtr ctr1
;
1565 [case(2)] samr_ValidatePasswordRepCtr ctr2
;
1566 [case(3)] samr_ValidatePasswordRepCtr ctr3
;
1567 } samr_ValidatePasswordRep
;
1570 samr_ValidatePasswordInfo info
;
1571 lsa_StringLarge password
;
1572 lsa_StringLarge account
;
1573 samr_ValidationBlob hash
;
1574 boolean8 pwd_must_change_at_next_logon
;
1575 boolean8 clear_lockout
;
1576 } samr_ValidatePasswordReq3
;
1579 samr_ValidatePasswordInfo info
;
1580 lsa_StringLarge password
;
1581 lsa_StringLarge account
;
1582 samr_ValidationBlob hash
;
1583 boolean8 password_matched
;
1584 } samr_ValidatePasswordReq2
;
1587 samr_ValidatePasswordInfo info
;
1588 boolean8 password_matched
;
1589 } samr_ValidatePasswordReq1
;
1591 typedef [switch_type(uint16
)] union {
1592 [case(1)] samr_ValidatePasswordReq1 req1
;
1593 [case(2)] samr_ValidatePasswordReq2 req2
;
1594 [case(3)] samr_ValidatePasswordReq3 req3
;
1595 } samr_ValidatePasswordReq
;
1597 NTSTATUS samr_ValidatePassword
(
1598 [in] samr_ValidatePasswordLevel level
,
1599 [in,switch_is(level
)] samr_ValidatePasswordReq
*req
,
1600 [out,ref,switch_is(level
)] samr_ValidatePasswordRep
**rep