Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1483 lines
42 KiB

  1. /*++ BUILD Version: 0002 // Increment this if a change has global effects
  2. Copyright (c) 1991-1999 Microsoft Corporation
  3. Module Name:
  4. lmaccess.h
  5. Abstract:
  6. This file contains structures, function prototypes, and definitions
  7. for the NetUser, NetUserModals, NetGroup, NetAccess, and NetLogon API.
  8. Environment:
  9. User Mode - Win32
  10. Notes:
  11. You must include NETCONS.H before this file, since this file depends
  12. on values defined in NETCONS.H.
  13. --*/
  14. //
  15. // User Class
  16. //
  17. #ifndef _LMUSER_
  18. #define _LMUSER_
  19. #if _MSC_VER > 1000
  20. #pragma once
  21. #endif
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. #include <lmcons.h> // unfortunately created a dependence on this
  26. //
  27. // Function Prototypes - User
  28. //
  29. NET_API_STATUS NET_API_FUNCTION
  30. NetUserAdd (
  31. IN LPCWSTR servername OPTIONAL,
  32. IN DWORD level,
  33. IN LPBYTE buf,
  34. OUT LPDWORD parm_err OPTIONAL
  35. );
  36. NET_API_STATUS NET_API_FUNCTION
  37. NetUserEnum (
  38. IN LPCWSTR servername OPTIONAL,
  39. IN DWORD level,
  40. IN DWORD filter,
  41. OUT LPBYTE *bufptr,
  42. IN DWORD prefmaxlen,
  43. OUT LPDWORD entriesread,
  44. OUT LPDWORD totalentries,
  45. IN OUT LPDWORD resume_handle OPTIONAL
  46. );
  47. NET_API_STATUS NET_API_FUNCTION
  48. NetUserGetInfo (
  49. IN LPCWSTR servername OPTIONAL,
  50. IN LPCWSTR username,
  51. IN DWORD level,
  52. OUT LPBYTE *bufptr
  53. );
  54. NET_API_STATUS NET_API_FUNCTION
  55. NetUserSetInfo (
  56. IN LPCWSTR servername OPTIONAL,
  57. IN LPCWSTR username,
  58. IN DWORD level,
  59. IN LPBYTE buf,
  60. OUT LPDWORD parm_err OPTIONAL
  61. );
  62. NET_API_STATUS NET_API_FUNCTION
  63. NetUserDel (
  64. IN LPCWSTR servername OPTIONAL,
  65. IN LPCWSTR username
  66. );
  67. NET_API_STATUS NET_API_FUNCTION
  68. NetUserGetGroups (
  69. IN LPCWSTR servername OPTIONAL,
  70. IN LPCWSTR username,
  71. IN DWORD level,
  72. OUT LPBYTE *bufptr,
  73. IN DWORD prefmaxlen,
  74. OUT LPDWORD entriesread,
  75. OUT LPDWORD totalentries
  76. );
  77. NET_API_STATUS NET_API_FUNCTION
  78. NetUserSetGroups (
  79. IN LPCWSTR servername OPTIONAL,
  80. IN LPCWSTR username,
  81. IN DWORD level,
  82. IN LPBYTE buf,
  83. IN DWORD num_entries
  84. );
  85. NET_API_STATUS NET_API_FUNCTION
  86. NetUserGetLocalGroups (
  87. IN LPCWSTR servername OPTIONAL,
  88. IN LPCWSTR username,
  89. IN DWORD level,
  90. IN DWORD flags,
  91. OUT LPBYTE *bufptr,
  92. IN DWORD prefmaxlen,
  93. OUT LPDWORD entriesread,
  94. OUT LPDWORD totalentries
  95. );
  96. NET_API_STATUS NET_API_FUNCTION
  97. NetUserModalsGet (
  98. IN LPCWSTR servername OPTIONAL,
  99. IN DWORD level,
  100. OUT LPBYTE *bufptr
  101. );
  102. NET_API_STATUS NET_API_FUNCTION
  103. NetUserModalsSet (
  104. IN LPCWSTR servername OPTIONAL,
  105. IN DWORD level,
  106. IN LPBYTE buf,
  107. OUT LPDWORD parm_err OPTIONAL
  108. );
  109. NET_API_STATUS NET_API_FUNCTION
  110. NetUserChangePassword (
  111. IN LPCWSTR domainname OPTIONAL,
  112. IN LPCWSTR username OPTIONAL,
  113. IN LPCWSTR oldpassword,
  114. IN LPCWSTR newpassword
  115. );
  116. //
  117. // Data Structures - User
  118. //
  119. typedef struct _USER_INFO_0 {
  120. LPWSTR usri0_name;
  121. }USER_INFO_0, *PUSER_INFO_0, *LPUSER_INFO_0;
  122. typedef struct _USER_INFO_1 {
  123. LPWSTR usri1_name;
  124. LPWSTR usri1_password;
  125. DWORD usri1_password_age;
  126. DWORD usri1_priv;
  127. LPWSTR usri1_home_dir;
  128. LPWSTR usri1_comment;
  129. DWORD usri1_flags;
  130. LPWSTR usri1_script_path;
  131. }USER_INFO_1, *PUSER_INFO_1, *LPUSER_INFO_1;
  132. typedef struct _USER_INFO_2 {
  133. LPWSTR usri2_name;
  134. LPWSTR usri2_password;
  135. DWORD usri2_password_age;
  136. DWORD usri2_priv;
  137. LPWSTR usri2_home_dir;
  138. LPWSTR usri2_comment;
  139. DWORD usri2_flags;
  140. LPWSTR usri2_script_path;
  141. DWORD usri2_auth_flags;
  142. LPWSTR usri2_full_name;
  143. LPWSTR usri2_usr_comment;
  144. LPWSTR usri2_parms;
  145. LPWSTR usri2_workstations;
  146. DWORD usri2_last_logon;
  147. DWORD usri2_last_logoff;
  148. DWORD usri2_acct_expires;
  149. DWORD usri2_max_storage;
  150. DWORD usri2_units_per_week;
  151. PBYTE usri2_logon_hours;
  152. DWORD usri2_bad_pw_count;
  153. DWORD usri2_num_logons;
  154. LPWSTR usri2_logon_server;
  155. DWORD usri2_country_code;
  156. DWORD usri2_code_page;
  157. }USER_INFO_2, *PUSER_INFO_2, *LPUSER_INFO_2;
  158. typedef struct _USER_INFO_3 {
  159. LPWSTR usri3_name;
  160. LPWSTR usri3_password;
  161. DWORD usri3_password_age;
  162. DWORD usri3_priv;
  163. LPWSTR usri3_home_dir;
  164. LPWSTR usri3_comment;
  165. DWORD usri3_flags;
  166. LPWSTR usri3_script_path;
  167. DWORD usri3_auth_flags;
  168. LPWSTR usri3_full_name;
  169. LPWSTR usri3_usr_comment;
  170. LPWSTR usri3_parms;
  171. LPWSTR usri3_workstations;
  172. DWORD usri3_last_logon;
  173. DWORD usri3_last_logoff;
  174. DWORD usri3_acct_expires;
  175. DWORD usri3_max_storage;
  176. DWORD usri3_units_per_week;
  177. PBYTE usri3_logon_hours;
  178. DWORD usri3_bad_pw_count;
  179. DWORD usri3_num_logons;
  180. LPWSTR usri3_logon_server;
  181. DWORD usri3_country_code;
  182. DWORD usri3_code_page;
  183. DWORD usri3_user_id;
  184. DWORD usri3_primary_group_id;
  185. LPWSTR usri3_profile;
  186. LPWSTR usri3_home_dir_drive;
  187. DWORD usri3_password_expired;
  188. }USER_INFO_3, *PUSER_INFO_3, *LPUSER_INFO_3;
  189. typedef struct _USER_INFO_4 {
  190. LPWSTR usri4_name;
  191. LPWSTR usri4_password;
  192. DWORD usri4_password_age;
  193. DWORD usri4_priv;
  194. LPWSTR usri4_home_dir;
  195. LPWSTR usri4_comment;
  196. DWORD usri4_flags;
  197. LPWSTR usri4_script_path;
  198. DWORD usri4_auth_flags;
  199. LPWSTR usri4_full_name;
  200. LPWSTR usri4_usr_comment;
  201. LPWSTR usri4_parms;
  202. LPWSTR usri4_workstations;
  203. DWORD usri4_last_logon;
  204. DWORD usri4_last_logoff;
  205. DWORD usri4_acct_expires;
  206. DWORD usri4_max_storage;
  207. DWORD usri4_units_per_week;
  208. PBYTE usri4_logon_hours;
  209. DWORD usri4_bad_pw_count;
  210. DWORD usri4_num_logons;
  211. LPWSTR usri4_logon_server;
  212. DWORD usri4_country_code;
  213. DWORD usri4_code_page;
  214. PSID usri4_user_sid;
  215. DWORD usri4_primary_group_id;
  216. LPWSTR usri4_profile;
  217. LPWSTR usri4_home_dir_drive;
  218. DWORD usri4_password_expired;
  219. }USER_INFO_4, *PUSER_INFO_4, *LPUSER_INFO_4;
  220. typedef struct _USER_INFO_10 {
  221. LPWSTR usri10_name;
  222. LPWSTR usri10_comment;
  223. LPWSTR usri10_usr_comment;
  224. LPWSTR usri10_full_name;
  225. }USER_INFO_10, *PUSER_INFO_10, *LPUSER_INFO_10;
  226. typedef struct _USER_INFO_11 {
  227. LPWSTR usri11_name;
  228. LPWSTR usri11_comment;
  229. LPWSTR usri11_usr_comment;
  230. LPWSTR usri11_full_name;
  231. DWORD usri11_priv;
  232. DWORD usri11_auth_flags;
  233. DWORD usri11_password_age;
  234. LPWSTR usri11_home_dir;
  235. LPWSTR usri11_parms;
  236. DWORD usri11_last_logon;
  237. DWORD usri11_last_logoff;
  238. DWORD usri11_bad_pw_count;
  239. DWORD usri11_num_logons;
  240. LPWSTR usri11_logon_server;
  241. DWORD usri11_country_code;
  242. LPWSTR usri11_workstations;
  243. DWORD usri11_max_storage;
  244. DWORD usri11_units_per_week;
  245. PBYTE usri11_logon_hours;
  246. DWORD usri11_code_page;
  247. }USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;
  248. typedef struct _USER_INFO_20 {
  249. LPWSTR usri20_name;
  250. LPWSTR usri20_full_name;
  251. LPWSTR usri20_comment;
  252. DWORD usri20_flags;
  253. DWORD usri20_user_id;
  254. }USER_INFO_20, *PUSER_INFO_20, *LPUSER_INFO_20;
  255. typedef struct _USER_INFO_21 {
  256. BYTE usri21_password[ENCRYPTED_PWLEN];
  257. }USER_INFO_21, *PUSER_INFO_21, *LPUSER_INFO_21;
  258. typedef struct _USER_INFO_22 {
  259. LPWSTR usri22_name;
  260. BYTE usri22_password[ENCRYPTED_PWLEN];
  261. DWORD usri22_password_age;
  262. DWORD usri22_priv;
  263. LPWSTR usri22_home_dir;
  264. LPWSTR usri22_comment;
  265. DWORD usri22_flags;
  266. LPWSTR usri22_script_path;
  267. DWORD usri22_auth_flags;
  268. LPWSTR usri22_full_name;
  269. LPWSTR usri22_usr_comment;
  270. LPWSTR usri22_parms;
  271. LPWSTR usri22_workstations;
  272. DWORD usri22_last_logon;
  273. DWORD usri22_last_logoff;
  274. DWORD usri22_acct_expires;
  275. DWORD usri22_max_storage;
  276. DWORD usri22_units_per_week;
  277. PBYTE usri22_logon_hours;
  278. DWORD usri22_bad_pw_count;
  279. DWORD usri22_num_logons;
  280. LPWSTR usri22_logon_server;
  281. DWORD usri22_country_code;
  282. DWORD usri22_code_page;
  283. }USER_INFO_22, *PUSER_INFO_22, *LPUSER_INFO_22;
  284. typedef struct _USER_INFO_23 {
  285. LPWSTR usri23_name;
  286. LPWSTR usri23_full_name;
  287. LPWSTR usri23_comment;
  288. DWORD usri23_flags;
  289. PSID usri23_user_sid;
  290. }USER_INFO_23, *PUSER_INFO_23, *LPUSER_INFO_23;
  291. typedef struct _USER_INFO_1003 {
  292. LPWSTR usri1003_password;
  293. } USER_INFO_1003, *PUSER_INFO_1003, *LPUSER_INFO_1003;
  294. typedef struct _USER_INFO_1005 {
  295. DWORD usri1005_priv;
  296. } USER_INFO_1005, *PUSER_INFO_1005, *LPUSER_INFO_1005;
  297. typedef struct _USER_INFO_1006 {
  298. LPWSTR usri1006_home_dir;
  299. } USER_INFO_1006, *PUSER_INFO_1006, *LPUSER_INFO_1006;
  300. typedef struct _USER_INFO_1007 {
  301. LPWSTR usri1007_comment;
  302. } USER_INFO_1007, *PUSER_INFO_1007, *LPUSER_INFO_1007;
  303. typedef struct _USER_INFO_1008 {
  304. DWORD usri1008_flags;
  305. } USER_INFO_1008, *PUSER_INFO_1008, *LPUSER_INFO_1008;
  306. typedef struct _USER_INFO_1009 {
  307. LPWSTR usri1009_script_path;
  308. } USER_INFO_1009, *PUSER_INFO_1009, *LPUSER_INFO_1009;
  309. typedef struct _USER_INFO_1010 {
  310. DWORD usri1010_auth_flags;
  311. } USER_INFO_1010, *PUSER_INFO_1010, *LPUSER_INFO_1010;
  312. typedef struct _USER_INFO_1011 {
  313. LPWSTR usri1011_full_name;
  314. } USER_INFO_1011, *PUSER_INFO_1011, *LPUSER_INFO_1011;
  315. typedef struct _USER_INFO_1012 {
  316. LPWSTR usri1012_usr_comment;
  317. } USER_INFO_1012, *PUSER_INFO_1012, *LPUSER_INFO_1012;
  318. typedef struct _USER_INFO_1013 {
  319. LPWSTR usri1013_parms;
  320. } USER_INFO_1013, *PUSER_INFO_1013, *LPUSER_INFO_1013;
  321. typedef struct _USER_INFO_1014 {
  322. LPWSTR usri1014_workstations;
  323. } USER_INFO_1014, *PUSER_INFO_1014, *LPUSER_INFO_1014;
  324. typedef struct _USER_INFO_1017 {
  325. DWORD usri1017_acct_expires;
  326. } USER_INFO_1017, *PUSER_INFO_1017, *LPUSER_INFO_1017;
  327. typedef struct _USER_INFO_1018 {
  328. DWORD usri1018_max_storage;
  329. } USER_INFO_1018, *PUSER_INFO_1018, *LPUSER_INFO_1018;
  330. typedef struct _USER_INFO_1020 {
  331. DWORD usri1020_units_per_week;
  332. LPBYTE usri1020_logon_hours;
  333. } USER_INFO_1020, *PUSER_INFO_1020, *LPUSER_INFO_1020;
  334. typedef struct _USER_INFO_1023 {
  335. LPWSTR usri1023_logon_server;
  336. } USER_INFO_1023, *PUSER_INFO_1023, *LPUSER_INFO_1023;
  337. typedef struct _USER_INFO_1024 {
  338. DWORD usri1024_country_code;
  339. } USER_INFO_1024, *PUSER_INFO_1024, *LPUSER_INFO_1024;
  340. typedef struct _USER_INFO_1025 {
  341. DWORD usri1025_code_page;
  342. } USER_INFO_1025, *PUSER_INFO_1025, *LPUSER_INFO_1025;
  343. typedef struct _USER_INFO_1051 {
  344. DWORD usri1051_primary_group_id;
  345. } USER_INFO_1051, *PUSER_INFO_1051, *LPUSER_INFO_1051;
  346. typedef struct _USER_INFO_1052 {
  347. LPWSTR usri1052_profile;
  348. } USER_INFO_1052, *PUSER_INFO_1052, *LPUSER_INFO_1052;
  349. typedef struct _USER_INFO_1053 {
  350. LPWSTR usri1053_home_dir_drive;
  351. } USER_INFO_1053, *PUSER_INFO_1053, *LPUSER_INFO_1053;
  352. //
  353. // Data Structures - User Modals
  354. //
  355. typedef struct _USER_MODALS_INFO_0 {
  356. DWORD usrmod0_min_passwd_len;
  357. DWORD usrmod0_max_passwd_age;
  358. DWORD usrmod0_min_passwd_age;
  359. DWORD usrmod0_force_logoff;
  360. DWORD usrmod0_password_hist_len;
  361. }USER_MODALS_INFO_0, *PUSER_MODALS_INFO_0, *LPUSER_MODALS_INFO_0;
  362. typedef struct _USER_MODALS_INFO_1 {
  363. DWORD usrmod1_role;
  364. LPWSTR usrmod1_primary;
  365. }USER_MODALS_INFO_1, *PUSER_MODALS_INFO_1, *LPUSER_MODALS_INFO_1;
  366. typedef struct _USER_MODALS_INFO_2 {
  367. LPWSTR usrmod2_domain_name;
  368. PSID usrmod2_domain_id;
  369. }USER_MODALS_INFO_2, *PUSER_MODALS_INFO_2, *LPUSER_MODALS_INFO_2;
  370. typedef struct _USER_MODALS_INFO_3 {
  371. DWORD usrmod3_lockout_duration;
  372. DWORD usrmod3_lockout_observation_window;
  373. DWORD usrmod3_lockout_threshold;
  374. }USER_MODALS_INFO_3, *PUSER_MODALS_INFO_3, *LPUSER_MODALS_INFO_3;
  375. typedef struct _USER_MODALS_INFO_1001 {
  376. DWORD usrmod1001_min_passwd_len;
  377. } USER_MODALS_INFO_1001, *PUSER_MODALS_INFO_1001, *LPUSER_MODALS_INFO_1001;
  378. typedef struct _USER_MODALS_INFO_1002 {
  379. DWORD usrmod1002_max_passwd_age;
  380. } USER_MODALS_INFO_1002, *PUSER_MODALS_INFO_1002, *LPUSER_MODALS_INFO_1002;
  381. typedef struct _USER_MODALS_INFO_1003 {
  382. DWORD usrmod1003_min_passwd_age;
  383. } USER_MODALS_INFO_1003, *PUSER_MODALS_INFO_1003, *LPUSER_MODALS_INFO_1003;
  384. typedef struct _USER_MODALS_INFO_1004 {
  385. DWORD usrmod1004_force_logoff;
  386. } USER_MODALS_INFO_1004, *PUSER_MODALS_INFO_1004, *LPUSER_MODALS_INFO_1004;
  387. typedef struct _USER_MODALS_INFO_1005 {
  388. DWORD usrmod1005_password_hist_len;
  389. } USER_MODALS_INFO_1005, *PUSER_MODALS_INFO_1005, *LPUSER_MODALS_INFO_1005;
  390. typedef struct _USER_MODALS_INFO_1006 {
  391. DWORD usrmod1006_role;
  392. } USER_MODALS_INFO_1006, *PUSER_MODALS_INFO_1006, *LPUSER_MODALS_INFO_1006;
  393. typedef struct _USER_MODALS_INFO_1007 {
  394. LPWSTR usrmod1007_primary;
  395. } USER_MODALS_INFO_1007, *PUSER_MODALS_INFO_1007, *LPUSER_MODALS_INFO_1007;
  396. //
  397. // Special Values and Constants - User
  398. //
  399. //
  400. // Bit masks for field usriX_flags of USER_INFO_X (X = 0/1).
  401. //
  402. #define UF_SCRIPT 0x0001
  403. #define UF_ACCOUNTDISABLE 0x0002
  404. #define UF_HOMEDIR_REQUIRED 0x0008
  405. #define UF_LOCKOUT 0x0010
  406. #define UF_PASSWD_NOTREQD 0x0020
  407. #define UF_PASSWD_CANT_CHANGE 0x0040
  408. #define UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED 0x0080
  409. //
  410. // Account type bits as part of usri_flags.
  411. //
  412. #define UF_TEMP_DUPLICATE_ACCOUNT 0x0100
  413. #define UF_NORMAL_ACCOUNT 0x0200
  414. #define UF_INTERDOMAIN_TRUST_ACCOUNT 0x0800
  415. #define UF_WORKSTATION_TRUST_ACCOUNT 0x1000
  416. #define UF_SERVER_TRUST_ACCOUNT 0x2000
  417. #define UF_MACHINE_ACCOUNT_MASK ( UF_INTERDOMAIN_TRUST_ACCOUNT | \
  418. UF_WORKSTATION_TRUST_ACCOUNT | \
  419. UF_SERVER_TRUST_ACCOUNT )
  420. #define UF_ACCOUNT_TYPE_MASK ( \
  421. UF_TEMP_DUPLICATE_ACCOUNT | \
  422. UF_NORMAL_ACCOUNT | \
  423. UF_INTERDOMAIN_TRUST_ACCOUNT | \
  424. UF_WORKSTATION_TRUST_ACCOUNT | \
  425. UF_SERVER_TRUST_ACCOUNT \
  426. )
  427. #define UF_DONT_EXPIRE_PASSWD 0x10000
  428. #define UF_MNS_LOGON_ACCOUNT 0x20000
  429. #define UF_SMARTCARD_REQUIRED 0x40000
  430. #define UF_TRUSTED_FOR_DELEGATION 0x80000
  431. #define UF_NOT_DELEGATED 0x100000
  432. #define UF_USE_DES_KEY_ONLY 0x200000
  433. #define UF_DONT_REQUIRE_PREAUTH 0x400000
  434. #define UF_PASSWORD_EXPIRED 0x800000
  435. #define UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION 0x1000000
  436. #define UF_SETTABLE_BITS ( \
  437. UF_SCRIPT | \
  438. UF_ACCOUNTDISABLE | \
  439. UF_LOCKOUT | \
  440. UF_HOMEDIR_REQUIRED | \
  441. UF_PASSWD_NOTREQD | \
  442. UF_PASSWD_CANT_CHANGE | \
  443. UF_ACCOUNT_TYPE_MASK | \
  444. UF_DONT_EXPIRE_PASSWD | \
  445. UF_MNS_LOGON_ACCOUNT |\
  446. UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED |\
  447. UF_SMARTCARD_REQUIRED | \
  448. UF_TRUSTED_FOR_DELEGATION | \
  449. UF_NOT_DELEGATED | \
  450. UF_USE_DES_KEY_ONLY | \
  451. UF_DONT_REQUIRE_PREAUTH |\
  452. UF_PASSWORD_EXPIRED \
  453. )
  454. //
  455. // bit masks for the NetUserEnum filter parameter.
  456. //
  457. #define FILTER_TEMP_DUPLICATE_ACCOUNT (0x0001)
  458. #define FILTER_NORMAL_ACCOUNT (0x0002)
  459. // #define FILTER_PROXY_ACCOUNT (0x0004)
  460. #define FILTER_INTERDOMAIN_TRUST_ACCOUNT (0x0008)
  461. #define FILTER_WORKSTATION_TRUST_ACCOUNT (0x0010)
  462. #define FILTER_SERVER_TRUST_ACCOUNT (0x0020)
  463. //
  464. // bit masks for the NetUserGetLocalGroups flags
  465. //
  466. #define LG_INCLUDE_INDIRECT (0x0001)
  467. //
  468. // Bit masks for field usri2_auth_flags of USER_INFO_2.
  469. //
  470. #define AF_OP_PRINT 0x1
  471. #define AF_OP_COMM 0x2
  472. #define AF_OP_SERVER 0x4
  473. #define AF_OP_ACCOUNTS 0x8
  474. #define AF_SETTABLE_BITS (AF_OP_PRINT | AF_OP_COMM | \
  475. AF_OP_SERVER | AF_OP_ACCOUNTS)
  476. //
  477. // UAS role manifests under NETLOGON
  478. //
  479. #define UAS_ROLE_STANDALONE 0
  480. #define UAS_ROLE_MEMBER 1
  481. #define UAS_ROLE_BACKUP 2
  482. #define UAS_ROLE_PRIMARY 3
  483. //
  484. // Values for ParmError for NetUserSetInfo.
  485. //
  486. #define USER_NAME_PARMNUM 1
  487. #define USER_PASSWORD_PARMNUM 3
  488. #define USER_PASSWORD_AGE_PARMNUM 4
  489. #define USER_PRIV_PARMNUM 5
  490. #define USER_HOME_DIR_PARMNUM 6
  491. #define USER_COMMENT_PARMNUM 7
  492. #define USER_FLAGS_PARMNUM 8
  493. #define USER_SCRIPT_PATH_PARMNUM 9
  494. #define USER_AUTH_FLAGS_PARMNUM 10
  495. #define USER_FULL_NAME_PARMNUM 11
  496. #define USER_USR_COMMENT_PARMNUM 12
  497. #define USER_PARMS_PARMNUM 13
  498. #define USER_WORKSTATIONS_PARMNUM 14
  499. #define USER_LAST_LOGON_PARMNUM 15
  500. #define USER_LAST_LOGOFF_PARMNUM 16
  501. #define USER_ACCT_EXPIRES_PARMNUM 17
  502. #define USER_MAX_STORAGE_PARMNUM 18
  503. #define USER_UNITS_PER_WEEK_PARMNUM 19
  504. #define USER_LOGON_HOURS_PARMNUM 20
  505. #define USER_PAD_PW_COUNT_PARMNUM 21
  506. #define USER_NUM_LOGONS_PARMNUM 22
  507. #define USER_LOGON_SERVER_PARMNUM 23
  508. #define USER_COUNTRY_CODE_PARMNUM 24
  509. #define USER_CODE_PAGE_PARMNUM 25
  510. #define USER_PRIMARY_GROUP_PARMNUM 51
  511. #define USER_PROFILE 52 // ?? Delete when convenient
  512. #define USER_PROFILE_PARMNUM 52
  513. #define USER_HOME_DIR_DRIVE_PARMNUM 53
  514. //
  515. // the new infolevel counterparts of the old info level + parmnum
  516. //
  517. #define USER_NAME_INFOLEVEL \
  518. (PARMNUM_BASE_INFOLEVEL + USER_NAME_PARMNUM)
  519. #define USER_PASSWORD_INFOLEVEL \
  520. (PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_PARMNUM)
  521. #define USER_PASSWORD_AGE_INFOLEVEL \
  522. (PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_AGE_PARMNUM)
  523. #define USER_PRIV_INFOLEVEL \
  524. (PARMNUM_BASE_INFOLEVEL + USER_PRIV_PARMNUM)
  525. #define USER_HOME_DIR_INFOLEVEL \
  526. (PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_PARMNUM)
  527. #define USER_COMMENT_INFOLEVEL \
  528. (PARMNUM_BASE_INFOLEVEL + USER_COMMENT_PARMNUM)
  529. #define USER_FLAGS_INFOLEVEL \
  530. (PARMNUM_BASE_INFOLEVEL + USER_FLAGS_PARMNUM)
  531. #define USER_SCRIPT_PATH_INFOLEVEL \
  532. (PARMNUM_BASE_INFOLEVEL + USER_SCRIPT_PATH_PARMNUM)
  533. #define USER_AUTH_FLAGS_INFOLEVEL \
  534. (PARMNUM_BASE_INFOLEVEL + USER_AUTH_FLAGS_PARMNUM)
  535. #define USER_FULL_NAME_INFOLEVEL \
  536. (PARMNUM_BASE_INFOLEVEL + USER_FULL_NAME_PARMNUM)
  537. #define USER_USR_COMMENT_INFOLEVEL \
  538. (PARMNUM_BASE_INFOLEVEL + USER_USR_COMMENT_PARMNUM)
  539. #define USER_PARMS_INFOLEVEL \
  540. (PARMNUM_BASE_INFOLEVEL + USER_PARMS_PARMNUM)
  541. #define USER_WORKSTATIONS_INFOLEVEL \
  542. (PARMNUM_BASE_INFOLEVEL + USER_WORKSTATIONS_PARMNUM)
  543. #define USER_LAST_LOGON_INFOLEVEL \
  544. (PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGON_PARMNUM)
  545. #define USER_LAST_LOGOFF_INFOLEVEL \
  546. (PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGOFF_PARMNUM)
  547. #define USER_ACCT_EXPIRES_INFOLEVEL \
  548. (PARMNUM_BASE_INFOLEVEL + USER_ACCT_EXPIRES_PARMNUM)
  549. #define USER_MAX_STORAGE_INFOLEVEL \
  550. (PARMNUM_BASE_INFOLEVEL + USER_MAX_STORAGE_PARMNUM)
  551. #define USER_UNITS_PER_WEEK_INFOLEVEL \
  552. (PARMNUM_BASE_INFOLEVEL + USER_UNITS_PER_WEEK_PARMNUM)
  553. #define USER_LOGON_HOURS_INFOLEVEL \
  554. (PARMNUM_BASE_INFOLEVEL + USER_LOGON_HOURS_PARMNUM)
  555. #define USER_PAD_PW_COUNT_INFOLEVEL \
  556. (PARMNUM_BASE_INFOLEVEL + USER_PAD_PW_COUNT_PARMNUM)
  557. #define USER_NUM_LOGONS_INFOLEVEL \
  558. (PARMNUM_BASE_INFOLEVEL + USER_NUM_LOGONS_PARMNUM)
  559. #define USER_LOGON_SERVER_INFOLEVEL \
  560. (PARMNUM_BASE_INFOLEVEL + USER_LOGON_SERVER_PARMNUM)
  561. #define USER_COUNTRY_CODE_INFOLEVEL \
  562. (PARMNUM_BASE_INFOLEVEL + USER_COUNTRY_CODE_PARMNUM)
  563. #define USER_CODE_PAGE_INFOLEVEL \
  564. (PARMNUM_BASE_INFOLEVEL + USER_CODE_PAGE_PARMNUM)
  565. #define USER_PRIMARY_GROUP_INFOLEVEL \
  566. (PARMNUM_BASE_INFOLEVEL + USER_PRIMARY_GROUP_PARMNUM)
  567. #define USER_POSIX_ID_INFOLEVEL \
  568. (PARMNUM_BASE_INFOLEVEL + USER_POSIX_ID_PARMNUM)
  569. #define USER_HOME_DIR_DRIVE_INFOLEVEL \
  570. (PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_DRIVE_PARMNUM)
  571. //
  572. // For SetInfo call (parmnum 0) when password change not required
  573. //
  574. #define NULL_USERSETINFO_PASSWD " "
  575. #define TIMEQ_FOREVER ((unsigned long) -1L)
  576. #define USER_MAXSTORAGE_UNLIMITED ((unsigned long) -1L)
  577. #define USER_NO_LOGOFF ((unsigned long) -1L)
  578. #define UNITS_PER_DAY 24
  579. #define UNITS_PER_WEEK UNITS_PER_DAY * 7
  580. //
  581. // Privilege levels (USER_INFO_X field usriX_priv (X = 0/1)).
  582. //
  583. #define USER_PRIV_MASK 0x3
  584. #define USER_PRIV_GUEST 0
  585. #define USER_PRIV_USER 1
  586. #define USER_PRIV_ADMIN 2
  587. //
  588. // user modals related defaults
  589. //
  590. #define MAX_PASSWD_LEN PWLEN
  591. #define DEF_MIN_PWLEN 6
  592. #define DEF_PWUNIQUENESS 5
  593. #define DEF_MAX_PWHIST 8
  594. #define DEF_MAX_PWAGE TIMEQ_FOREVER // forever
  595. #define DEF_MIN_PWAGE (unsigned long) 0L // 0 days
  596. #define DEF_FORCE_LOGOFF (unsigned long) 0xffffffff // never
  597. #define DEF_MAX_BADPW 0 // no limit
  598. #define ONE_DAY (unsigned long) 01*24*3600 // 01 day
  599. //
  600. // User Logon Validation (codes returned)
  601. //
  602. #define VALIDATED_LOGON 0
  603. #define PASSWORD_EXPIRED 2
  604. #define NON_VALIDATED_LOGON 3
  605. #define VALID_LOGOFF 1
  606. //
  607. // parmnum manifests for user modals
  608. //
  609. #define MODALS_MIN_PASSWD_LEN_PARMNUM 1
  610. #define MODALS_MAX_PASSWD_AGE_PARMNUM 2
  611. #define MODALS_MIN_PASSWD_AGE_PARMNUM 3
  612. #define MODALS_FORCE_LOGOFF_PARMNUM 4
  613. #define MODALS_PASSWD_HIST_LEN_PARMNUM 5
  614. #define MODALS_ROLE_PARMNUM 6
  615. #define MODALS_PRIMARY_PARMNUM 7
  616. #define MODALS_DOMAIN_NAME_PARMNUM 8
  617. #define MODALS_DOMAIN_ID_PARMNUM 9
  618. #define MODALS_LOCKOUT_DURATION_PARMNUM 10
  619. #define MODALS_LOCKOUT_OBSERVATION_WINDOW_PARMNUM 11
  620. #define MODALS_LOCKOUT_THRESHOLD_PARMNUM 12
  621. //
  622. // the new infolevel counterparts of the old info level + parmnum
  623. //
  624. #define MODALS_MIN_PASSWD_LEN_INFOLEVEL \
  625. (PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_LEN_PARMNUM)
  626. #define MODALS_MAX_PASSWD_AGE_INFOLEVEL \
  627. (PARMNUM_BASE_INFOLEVEL + MODALS_MAX_PASSWD_AGE_PARMNUM)
  628. #define MODALS_MIN_PASSWD_AGE_INFOLEVEL \
  629. (PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_AGE_PARMNUM)
  630. #define MODALS_FORCE_LOGOFF_INFOLEVEL \
  631. (PARMNUM_BASE_INFOLEVEL + MODALS_FORCE_LOGOFF_PARMNUM)
  632. #define MODALS_PASSWD_HIST_LEN_INFOLEVEL \
  633. (PARMNUM_BASE_INFOLEVEL + MODALS_PASSWD_HIST_LEN_PARMNUM)
  634. #define MODALS_ROLE_INFOLEVEL \
  635. (PARMNUM_BASE_INFOLEVEL + MODALS_ROLE_PARMNUM)
  636. #define MODALS_PRIMARY_INFOLEVEL \
  637. (PARMNUM_BASE_INFOLEVEL + MODALS_PRIMARY_PARMNUM)
  638. #define MODALS_DOMAIN_NAME_INFOLEVEL \
  639. (PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_NAME_PARMNUM)
  640. #define MODALS_DOMAIN_ID_INFOLEVEL \
  641. (PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_ID_PARMNUM)
  642. #endif // _LMUSER_
  643. //
  644. // Group Class
  645. //
  646. #ifndef _LMGROUP_
  647. #define _LMGROUP_
  648. //
  649. // Function Prototypes
  650. //
  651. NET_API_STATUS NET_API_FUNCTION
  652. NetGroupAdd (
  653. IN LPCWSTR servername OPTIONAL,
  654. IN DWORD level,
  655. IN LPBYTE buf,
  656. OUT LPDWORD parm_err OPTIONAL
  657. );
  658. NET_API_STATUS NET_API_FUNCTION
  659. NetGroupAddUser (
  660. IN LPCWSTR servername OPTIONAL,
  661. IN LPCWSTR GroupName,
  662. IN LPCWSTR username
  663. );
  664. NET_API_STATUS NET_API_FUNCTION
  665. NetGroupEnum (
  666. IN LPCWSTR servername OPTIONAL,
  667. IN DWORD level,
  668. OUT LPBYTE *bufptr,
  669. IN DWORD prefmaxlen,
  670. OUT LPDWORD entriesread,
  671. OUT LPDWORD totalentries,
  672. IN OUT PDWORD_PTR resume_handle OPTIONAL
  673. );
  674. NET_API_STATUS NET_API_FUNCTION
  675. NetGroupGetInfo (
  676. IN LPCWSTR servername OPTIONAL,
  677. IN LPCWSTR groupname,
  678. IN DWORD level,
  679. OUT LPBYTE *bufptr
  680. );
  681. NET_API_STATUS NET_API_FUNCTION
  682. NetGroupSetInfo (
  683. IN LPCWSTR servername OPTIONAL,
  684. IN LPCWSTR groupname,
  685. IN DWORD level,
  686. IN LPBYTE buf,
  687. OUT LPDWORD parm_err OPTIONAL
  688. );
  689. NET_API_STATUS NET_API_FUNCTION
  690. NetGroupDel (
  691. IN LPCWSTR servername OPTIONAL,
  692. IN LPCWSTR groupname
  693. );
  694. NET_API_STATUS NET_API_FUNCTION
  695. NetGroupDelUser (
  696. IN LPCWSTR servername OPTIONAL,
  697. IN LPCWSTR GroupName,
  698. IN LPCWSTR Username
  699. );
  700. NET_API_STATUS NET_API_FUNCTION
  701. NetGroupGetUsers (
  702. IN LPCWSTR servername OPTIONAL,
  703. IN LPCWSTR groupname,
  704. IN DWORD level,
  705. OUT LPBYTE *bufptr,
  706. IN DWORD prefmaxlen,
  707. OUT LPDWORD entriesread,
  708. OUT LPDWORD totalentries,
  709. IN OUT PDWORD_PTR ResumeHandle
  710. );
  711. NET_API_STATUS NET_API_FUNCTION
  712. NetGroupSetUsers (
  713. IN LPCWSTR servername OPTIONAL,
  714. IN LPCWSTR groupname,
  715. IN DWORD level,
  716. IN LPBYTE buf,
  717. IN DWORD totalentries
  718. );
  719. //
  720. // Data Structures - Group
  721. //
  722. typedef struct _GROUP_INFO_0 {
  723. LPWSTR grpi0_name;
  724. }GROUP_INFO_0, *PGROUP_INFO_0, *LPGROUP_INFO_0;
  725. typedef struct _GROUP_INFO_1 {
  726. LPWSTR grpi1_name;
  727. LPWSTR grpi1_comment;
  728. }GROUP_INFO_1, *PGROUP_INFO_1, *LPGROUP_INFO_1;
  729. typedef struct _GROUP_INFO_2 {
  730. LPWSTR grpi2_name;
  731. LPWSTR grpi2_comment;
  732. DWORD grpi2_group_id;
  733. DWORD grpi2_attributes;
  734. }GROUP_INFO_2, *PGROUP_INFO_2;
  735. typedef struct _GROUP_INFO_3 {
  736. LPWSTR grpi3_name;
  737. LPWSTR grpi3_comment;
  738. PSID grpi3_group_sid;
  739. DWORD grpi3_attributes;
  740. }GROUP_INFO_3, *PGROUP_INFO_3;
  741. typedef struct _GROUP_INFO_1002 {
  742. LPWSTR grpi1002_comment;
  743. } GROUP_INFO_1002, *PGROUP_INFO_1002, *LPGROUP_INFO_1002;
  744. typedef struct _GROUP_INFO_1005 {
  745. DWORD grpi1005_attributes;
  746. } GROUP_INFO_1005, *PGROUP_INFO_1005, *LPGROUP_INFO_1005;
  747. typedef struct _GROUP_USERS_INFO_0 {
  748. LPWSTR grui0_name;
  749. } GROUP_USERS_INFO_0, *PGROUP_USERS_INFO_0, *LPGROUP_USERS_INFO_0;
  750. typedef struct _GROUP_USERS_INFO_1 {
  751. LPWSTR grui1_name;
  752. DWORD grui1_attributes;
  753. } GROUP_USERS_INFO_1, *PGROUP_USERS_INFO_1, *LPGROUP_USERS_INFO_1;
  754. //
  755. // Special Values and Constants - Group
  756. //
  757. #define GROUPIDMASK 0x8000 // MSB set if uid refers
  758. // to a group
  759. //
  760. // Predefined group for all normal users, administrators and guests
  761. // LOCAL is a special group for pinball local security.
  762. //
  763. #define GROUP_SPECIALGRP_USERS L"USERS"
  764. #define GROUP_SPECIALGRP_ADMINS L"ADMINS"
  765. #define GROUP_SPECIALGRP_GUESTS L"GUESTS"
  766. #define GROUP_SPECIALGRP_LOCAL L"LOCAL"
  767. //
  768. // parmnum manifests for SetInfo calls (only comment is settable)
  769. //
  770. #define GROUP_ALL_PARMNUM 0
  771. #define GROUP_NAME_PARMNUM 1
  772. #define GROUP_COMMENT_PARMNUM 2
  773. #define GROUP_ATTRIBUTES_PARMNUM 3
  774. //
  775. // the new infolevel counterparts of the old info level + parmnum
  776. //
  777. #define GROUP_ALL_INFOLEVEL \
  778. (PARMNUM_BASE_INFOLEVEL + GROUP_ALL_PARMNUM)
  779. #define GROUP_NAME_INFOLEVEL \
  780. (PARMNUM_BASE_INFOLEVEL + GROUP_NAME_PARMNUM)
  781. #define GROUP_COMMENT_INFOLEVEL \
  782. (PARMNUM_BASE_INFOLEVEL + GROUP_COMMENT_PARMNUM)
  783. #define GROUP_ATTRIBUTES_INFOLEVEL \
  784. (PARMNUM_BASE_INFOLEVEL + GROUP_ATTRIBUTES_PARMNUM)
  785. #define GROUP_POSIX_ID_INFOLEVEL \
  786. (PARMNUM_BASE_INFOLEVEL + GROUP_POSIX_ID_PARMNUM)
  787. #endif // _LMGROUP_
  788. //
  789. // LocalGroup Class
  790. //
  791. #ifndef _LMLOCALGROUP_
  792. #define _LMLOCALGROUP_
  793. //
  794. // Function Prototypes
  795. //
  796. NET_API_STATUS NET_API_FUNCTION
  797. NetLocalGroupAdd (
  798. IN LPCWSTR servername OPTIONAL,
  799. IN DWORD level,
  800. IN LPBYTE buf,
  801. OUT LPDWORD parm_err OPTIONAL
  802. );
  803. NET_API_STATUS NET_API_FUNCTION
  804. NetLocalGroupAddMember (
  805. IN LPCWSTR servername OPTIONAL,
  806. IN LPCWSTR groupname,
  807. IN PSID membersid
  808. );
  809. NET_API_STATUS NET_API_FUNCTION
  810. NetLocalGroupEnum (
  811. IN LPCWSTR servername OPTIONAL,
  812. IN DWORD level,
  813. OUT LPBYTE *bufptr,
  814. IN DWORD prefmaxlen,
  815. OUT LPDWORD entriesread,
  816. OUT LPDWORD totalentries,
  817. IN OUT PDWORD_PTR resumehandle OPTIONAL
  818. );
  819. NET_API_STATUS NET_API_FUNCTION
  820. NetLocalGroupGetInfo (
  821. IN LPCWSTR servername OPTIONAL,
  822. IN LPCWSTR groupname,
  823. IN DWORD level,
  824. OUT LPBYTE *bufptr
  825. );
  826. NET_API_STATUS NET_API_FUNCTION
  827. NetLocalGroupSetInfo (
  828. IN LPCWSTR servername OPTIONAL,
  829. IN LPCWSTR groupname,
  830. IN DWORD level,
  831. IN LPBYTE buf,
  832. OUT LPDWORD parm_err OPTIONAL
  833. );
  834. NET_API_STATUS NET_API_FUNCTION
  835. NetLocalGroupDel (
  836. IN LPCWSTR servername OPTIONAL,
  837. IN LPCWSTR groupname
  838. );
  839. NET_API_STATUS NET_API_FUNCTION
  840. NetLocalGroupDelMember (
  841. IN LPCWSTR servername OPTIONAL,
  842. IN LPCWSTR groupname,
  843. IN PSID membersid
  844. );
  845. NET_API_STATUS NET_API_FUNCTION
  846. NetLocalGroupGetMembers (
  847. IN LPCWSTR servername OPTIONAL,
  848. IN LPCWSTR localgroupname,
  849. IN DWORD level,
  850. OUT LPBYTE *bufptr,
  851. IN DWORD prefmaxlen,
  852. OUT LPDWORD entriesread,
  853. OUT LPDWORD totalentries,
  854. IN OUT PDWORD_PTR resumehandle
  855. );
  856. NET_API_STATUS NET_API_FUNCTION
  857. NetLocalGroupSetMembers (
  858. IN LPCWSTR servername OPTIONAL,
  859. IN LPCWSTR groupname,
  860. IN DWORD level,
  861. IN LPBYTE buf,
  862. IN DWORD totalentries
  863. );
  864. NET_API_STATUS NET_API_FUNCTION
  865. NetLocalGroupAddMembers (
  866. IN LPCWSTR servername OPTIONAL,
  867. IN LPCWSTR groupname,
  868. IN DWORD level,
  869. IN LPBYTE buf,
  870. IN DWORD totalentries
  871. );
  872. NET_API_STATUS NET_API_FUNCTION
  873. NetLocalGroupDelMembers (
  874. IN LPCWSTR servername OPTIONAL,
  875. IN LPCWSTR groupname,
  876. IN DWORD level,
  877. IN LPBYTE buf,
  878. IN DWORD totalentries
  879. );
  880. //
  881. // Data Structures - LocalGroup
  882. //
  883. typedef struct _LOCALGROUP_INFO_0 {
  884. LPWSTR lgrpi0_name;
  885. }LOCALGROUP_INFO_0, *PLOCALGROUP_INFO_0, *LPLOCALGROUP_INFO_0;
  886. typedef struct _LOCALGROUP_INFO_1 {
  887. LPWSTR lgrpi1_name;
  888. LPWSTR lgrpi1_comment;
  889. }LOCALGROUP_INFO_1, *PLOCALGROUP_INFO_1, *LPLOCALGROUP_INFO_1;
  890. typedef struct _LOCALGROUP_INFO_1002 {
  891. LPWSTR lgrpi1002_comment;
  892. }LOCALGROUP_INFO_1002, *PLOCALGROUP_INFO_1002, *LPLOCALGROUP_INFO_1002;
  893. typedef struct _LOCALGROUP_MEMBERS_INFO_0 {
  894. PSID lgrmi0_sid;
  895. } LOCALGROUP_MEMBERS_INFO_0, *PLOCALGROUP_MEMBERS_INFO_0,
  896. *LPLOCALGROUP_MEMBERS_INFO_0;
  897. typedef struct _LOCALGROUP_MEMBERS_INFO_1 {
  898. PSID lgrmi1_sid;
  899. SID_NAME_USE lgrmi1_sidusage;
  900. LPWSTR lgrmi1_name;
  901. } LOCALGROUP_MEMBERS_INFO_1, *PLOCALGROUP_MEMBERS_INFO_1,
  902. *LPLOCALGROUP_MEMBERS_INFO_1;
  903. typedef struct _LOCALGROUP_MEMBERS_INFO_2 {
  904. PSID lgrmi2_sid;
  905. SID_NAME_USE lgrmi2_sidusage;
  906. LPWSTR lgrmi2_domainandname;
  907. } LOCALGROUP_MEMBERS_INFO_2, *PLOCALGROUP_MEMBERS_INFO_2,
  908. *LPLOCALGROUP_MEMBERS_INFO_2;
  909. typedef struct _LOCALGROUP_MEMBERS_INFO_3 {
  910. LPWSTR lgrmi3_domainandname;
  911. } LOCALGROUP_MEMBERS_INFO_3, *PLOCALGROUP_MEMBERS_INFO_3,
  912. *LPLOCALGROUP_MEMBERS_INFO_3;
  913. typedef struct _LOCALGROUP_USERS_INFO_0 {
  914. LPWSTR lgrui0_name;
  915. } LOCALGROUP_USERS_INFO_0, *PLOCALGROUP_USERS_INFO_0,
  916. *LPLOCALGROUP_USERS_INFO_0;
  917. #define LOCALGROUP_NAME_PARMNUM 1
  918. #define LOCALGROUP_COMMENT_PARMNUM 2
  919. //
  920. // Display Information APIs
  921. //
  922. NET_API_STATUS NET_API_FUNCTION
  923. NetQueryDisplayInformation(
  924. IN LPCWSTR ServerName OPTIONAL,
  925. IN DWORD Level,
  926. IN DWORD Index,
  927. IN DWORD EntriesRequested,
  928. IN DWORD PreferredMaximumLength,
  929. OUT LPDWORD ReturnedEntryCount,
  930. OUT PVOID *SortedBuffer );
  931. NET_API_STATUS NET_API_FUNCTION
  932. NetGetDisplayInformationIndex(
  933. IN LPCWSTR ServerName OPTIONAL,
  934. IN DWORD Level,
  935. IN LPCWSTR Prefix,
  936. OUT LPDWORD Index );
  937. //
  938. // QueryDisplayInformation levels
  939. typedef struct _NET_DISPLAY_USER {
  940. LPWSTR usri1_name;
  941. LPWSTR usri1_comment;
  942. DWORD usri1_flags;
  943. LPWSTR usri1_full_name;
  944. DWORD usri1_user_id;
  945. DWORD usri1_next_index;
  946. } NET_DISPLAY_USER, *PNET_DISPLAY_USER;
  947. typedef struct _NET_DISPLAY_MACHINE {
  948. LPWSTR usri2_name;
  949. LPWSTR usri2_comment;
  950. DWORD usri2_flags;
  951. DWORD usri2_user_id;
  952. DWORD usri2_next_index;
  953. } NET_DISPLAY_MACHINE, *PNET_DISPLAY_MACHINE;
  954. typedef struct _NET_DISPLAY_GROUP {
  955. LPWSTR grpi3_name;
  956. LPWSTR grpi3_comment;
  957. DWORD grpi3_group_id;
  958. DWORD grpi3_attributes;
  959. DWORD grpi3_next_index;
  960. } NET_DISPLAY_GROUP, *PNET_DISPLAY_GROUP;
  961. #endif // _LMLOCALGROUP_
  962. //
  963. // Access Class
  964. //
  965. #ifndef _LMACCESS_
  966. #define _LMACCESS_
  967. //
  968. // Function Prototypes - Access
  969. //
  970. //
  971. // The NetAccess APIs are only available to downlevel
  972. //
  973. #define NetAccessAdd RxNetAccessAdd
  974. NET_API_STATUS NET_API_FUNCTION
  975. NetAccessAdd (
  976. IN LPCWSTR servername OPTIONAL,
  977. IN DWORD level,
  978. IN LPBYTE buf,
  979. OUT LPDWORD parm_err OPTIONAL
  980. );
  981. #define NetAccessEnum RxNetAccessEnum
  982. NET_API_STATUS NET_API_FUNCTION
  983. NetAccessEnum (
  984. IN LPCWSTR servername OPTIONAL,
  985. IN LPCWSTR BasePath,
  986. IN DWORD Recursive,
  987. IN DWORD level,
  988. OUT LPBYTE *bufptr,
  989. IN DWORD prefmaxlen,
  990. OUT LPDWORD entriesread,
  991. OUT LPDWORD totalentries,
  992. IN OUT LPDWORD resume_handle OPTIONAL
  993. );
  994. #define NetAccessGetInfo RxNetAccessGetInfo
  995. NET_API_STATUS NET_API_FUNCTION
  996. NetAccessGetInfo (
  997. IN LPCWSTR servername OPTIONAL,
  998. IN LPCWSTR resource,
  999. IN DWORD level,
  1000. OUT LPBYTE *bufptr
  1001. );
  1002. #define NetAccessSetInfo RxNetAccessSetInfo
  1003. NET_API_STATUS NET_API_FUNCTION
  1004. NetAccessSetInfo (
  1005. IN LPCWSTR servername OPTIONAL,
  1006. IN LPCWSTR resource,
  1007. IN DWORD level,
  1008. IN LPBYTE buf,
  1009. OUT LPDWORD parm_err OPTIONAL
  1010. );
  1011. #define NetAccessDel RxNetAccessDel
  1012. NET_API_STATUS NET_API_FUNCTION
  1013. NetAccessDel (
  1014. IN LPCWSTR servername OPTIONAL,
  1015. IN LPCWSTR resource
  1016. );
  1017. #define NetAccessGetUserPerms RxNetAccessGetUserPerms
  1018. NET_API_STATUS NET_API_FUNCTION
  1019. NetAccessGetUserPerms (
  1020. IN LPCWSTR servername OPTIONAL,
  1021. IN LPCWSTR UGname,
  1022. IN LPCWSTR resource,
  1023. OUT LPDWORD Perms
  1024. );
  1025. //
  1026. // Data Structures - Access
  1027. //
  1028. typedef struct _ACCESS_INFO_0 {
  1029. LPWSTR acc0_resource_name;
  1030. }ACCESS_INFO_0, *PACCESS_INFO_0, *LPACCESS_INFO_0;
  1031. typedef struct _ACCESS_INFO_1 {
  1032. LPWSTR acc1_resource_name;
  1033. DWORD acc1_attr;
  1034. DWORD acc1_count;
  1035. }ACCESS_INFO_1, *PACCESS_INFO_1, *LPACCESS_INFO_1;
  1036. typedef struct _ACCESS_INFO_1002 {
  1037. DWORD acc1002_attr;
  1038. } ACCESS_INFO_1002, *PACCESS_INFO_1002, *LPACCESS_INFO_1002;
  1039. typedef struct _ACCESS_LIST {
  1040. LPWSTR acl_ugname;
  1041. DWORD acl_access;
  1042. }ACCESS_LIST, *PACCESS_LIST, *LPACCESS_LIST;
  1043. //
  1044. // Special Values and Constants - Access
  1045. //
  1046. //
  1047. // Maximum number of permission entries for each resource.
  1048. //
  1049. #define MAXPERMENTRIES 64
  1050. //
  1051. // Bit values for the access permissions. ACCESS_ALL is a handy
  1052. // way to specify maximum permissions. These are used in
  1053. // acl_access field of access_list structures.
  1054. //
  1055. #define ACCESS_NONE 0
  1056. #define ACCESS_ALL ( ACCESS_READ | \
  1057. ACCESS_WRITE | \
  1058. ACCESS_CREATE | \
  1059. ACCESS_EXEC | \
  1060. ACCESS_DELETE | \
  1061. ACCESS_ATRIB | \
  1062. ACCESS_PERM \
  1063. )
  1064. #define ACCESS_READ 0x01
  1065. #define ACCESS_WRITE 0x02
  1066. #define ACCESS_CREATE 0x04
  1067. #define ACCESS_EXEC 0x08
  1068. #define ACCESS_DELETE 0x10
  1069. #define ACCESS_ATRIB 0x20
  1070. #define ACCESS_PERM 0x40
  1071. #define ACCESS_GROUP 0x8000
  1072. //
  1073. // Bit values for the acc1_attr field of the ACCESS_INFO_1 structure.
  1074. //
  1075. #define ACCESS_AUDIT 0x1
  1076. #define ACCESS_SUCCESS_OPEN 0x10
  1077. #define ACCESS_SUCCESS_WRITE 0x20
  1078. #define ACCESS_SUCCESS_DELETE 0x40
  1079. #define ACCESS_SUCCESS_ACL 0x80
  1080. #define ACCESS_SUCCESS_MASK 0xF0
  1081. #define ACCESS_FAIL_OPEN 0x100
  1082. #define ACCESS_FAIL_WRITE 0x200
  1083. #define ACCESS_FAIL_DELETE 0x400
  1084. #define ACCESS_FAIL_ACL 0x800
  1085. #define ACCESS_FAIL_MASK 0xF00
  1086. #define ACCESS_FAIL_SHIFT 4
  1087. //
  1088. // Parmnum value for NetAccessSetInfo.
  1089. //
  1090. #define ACCESS_RESOURCE_NAME_PARMNUM 1
  1091. #define ACCESS_ATTR_PARMNUM 2
  1092. #define ACCESS_COUNT_PARMNUM 3
  1093. #define ACCESS_ACCESS_LIST_PARMNUM 4
  1094. //
  1095. // the new infolevel counterparts of the old info level + parmnum
  1096. //
  1097. #define ACCESS_RESOURCE_NAME_INFOLEVEL \
  1098. (PARMNUM_BASE_INFOLEVEL + ACCESS_RESOURCE_NAME_PARMNUM)
  1099. #define ACCESS_ATTR_INFOLEVEL \
  1100. (PARMNUM_BASE_INFOLEVEL + ACCESS_ATTR_PARMNUM)
  1101. #define ACCESS_COUNT_INFOLEVEL \
  1102. (PARMNUM_BASE_INFOLEVEL + ACCESS_COUNT_PARMNUM)
  1103. #define ACCESS_ACCESS_LIST_INFOLEVEL \
  1104. (PARMNUM_BASE_INFOLEVEL + ACCESS_ACCESS_LIST_PARMNUM)
  1105. //
  1106. // ACCESS_LETTERS defines a letter for each bit position in
  1107. // the acl_access field of struct access_list. Note that some
  1108. // bits have a corresponding letter of ' ' (space).
  1109. //
  1110. #define ACCESS_LETTERS "RWCXDAP "
  1111. #endif // _LMACCESS_
  1112. //
  1113. // Domain Class
  1114. //
  1115. #ifndef _LMDOMAIN_
  1116. #define _LMDOMAIN_
  1117. //
  1118. // Function Prototypes - Domain
  1119. //
  1120. NET_API_STATUS NET_API_FUNCTION
  1121. NetGetDCName (
  1122. IN LPCWSTR servername OPTIONAL,
  1123. IN LPCWSTR domainname OPTIONAL,
  1124. OUT LPBYTE *bufptr
  1125. );
  1126. NET_API_STATUS NET_API_FUNCTION
  1127. NetGetAnyDCName (
  1128. IN LPCWSTR servername OPTIONAL,
  1129. IN LPCWSTR domainname OPTIONAL,
  1130. OUT LPBYTE *bufptr
  1131. );
  1132. NET_API_STATUS NET_API_FUNCTION
  1133. I_NetLogonControl(
  1134. IN LPCWSTR ServerName OPTIONAL,
  1135. IN DWORD FunctionCode,
  1136. IN DWORD QueryLevel,
  1137. OUT LPBYTE *Buffer
  1138. );
  1139. NET_API_STATUS NET_API_FUNCTION
  1140. I_NetLogonControl2(
  1141. IN LPCWSTR ServerName OPTIONAL,
  1142. IN DWORD FunctionCode,
  1143. IN DWORD QueryLevel,
  1144. IN LPBYTE Data,
  1145. OUT LPBYTE *Buffer
  1146. );
  1147. #ifndef _NTDEF_
  1148. typedef LONG NTSTATUS, *PNTSTATUS;
  1149. #endif
  1150. NTSTATUS NET_API_FUNCTION
  1151. NetEnumerateTrustedDomains (
  1152. IN LPWSTR ServerName OPTIONAL,
  1153. OUT LPWSTR *DomainNames
  1154. );
  1155. //
  1156. // Special Values and Constants - Domain
  1157. //
  1158. //
  1159. // FunctionCode values for I_NetLogonControl.
  1160. //
  1161. // NOTE : if you change the following NETLOGON_CONTROL_* values,
  1162. // change them in net\svcdlls\logonsrv\logon.idl file also.
  1163. //
  1164. #define NETLOGON_CONTROL_QUERY 1 // No-op: just query
  1165. #define NETLOGON_CONTROL_REPLICATE 2 // Force replicate on BDC
  1166. #define NETLOGON_CONTROL_SYNCHRONIZE 3 // Force synchronize on BDC
  1167. #define NETLOGON_CONTROL_PDC_REPLICATE 4 // Force PDC to broadcast change
  1168. #define NETLOGON_CONTROL_REDISCOVER 5 // Force to re-discover trusted domain DCs
  1169. #define NETLOGON_CONTROL_TC_QUERY 6 // Query status of specified trusted channel status
  1170. #define NETLOGON_CONTROL_TRANSPORT_NOTIFY 7 // Notify netlogon that a new transport has come online
  1171. #define NETLOGON_CONTROL_FIND_USER 8 // Find named user in a trusted domain
  1172. #define NETLOGON_CONTROL_CHANGE_PASSWORD 9 // Change machine password on a secure channel to a trusted domain
  1173. #define NETLOGON_CONTROL_TC_VERIFY 10 // Verify status of specified trusted channel
  1174. #define NETLOGON_CONTROL_FORCE_DNS_REG 11 // Force DNS re-registration of all registered records
  1175. #define NETLOGON_CONTROL_QUERY_DNS_REG 12 // Query the status of DNS updates
  1176. // Debug function codes
  1177. #define NETLOGON_CONTROL_UNLOAD_NETLOGON_DLL 0xFFFB
  1178. #define NETLOGON_CONTROL_BACKUP_CHANGE_LOG 0xFFFC
  1179. #define NETLOGON_CONTROL_TRUNCATE_LOG 0xFFFD
  1180. #define NETLOGON_CONTROL_SET_DBFLAG 0xFFFE
  1181. #define NETLOGON_CONTROL_BREAKPOINT 0xFFFF
  1182. //
  1183. // Query level 1 for I_NetLogonControl
  1184. //
  1185. typedef struct _NETLOGON_INFO_1 {
  1186. DWORD netlog1_flags;
  1187. NET_API_STATUS netlog1_pdc_connection_status;
  1188. } NETLOGON_INFO_1, *PNETLOGON_INFO_1;
  1189. typedef struct _NETLOGON_INFO_2 {
  1190. DWORD netlog2_flags;
  1191. //
  1192. // If NETLOGON_VERIFY_STATUS_RETURNED bit is set in
  1193. // netlog2_flags, the following field will return
  1194. // the status of trust verification. Otherwise,
  1195. // the field will return the status of the secure
  1196. // channel to the primary domain of the machine
  1197. // (useful for BDCs only).
  1198. //
  1199. NET_API_STATUS netlog2_pdc_connection_status;
  1200. #ifdef MIDL_PASS
  1201. [string] wchar_t * netlog2_trusted_dc_name;
  1202. #else
  1203. LPWSTR netlog2_trusted_dc_name;
  1204. #endif // MIDL_PASS
  1205. NET_API_STATUS netlog2_tc_connection_status;
  1206. } NETLOGON_INFO_2, *PNETLOGON_INFO_2;
  1207. typedef struct _NETLOGON_INFO_3 {
  1208. DWORD netlog3_flags;
  1209. DWORD netlog3_logon_attempts;
  1210. DWORD netlog3_reserved1;
  1211. DWORD netlog3_reserved2;
  1212. DWORD netlog3_reserved3;
  1213. DWORD netlog3_reserved4;
  1214. DWORD netlog3_reserved5;
  1215. } NETLOGON_INFO_3, *PNETLOGON_INFO_3;
  1216. typedef struct _NETLOGON_INFO_4 {
  1217. #ifdef MIDL_PASS
  1218. [string] wchar_t * netlog4_trusted_dc_name;
  1219. [string] wchar_t * netlog4_trusted_domain_name;
  1220. #else
  1221. LPWSTR netlog4_trusted_dc_name;
  1222. LPWSTR netlog4_trusted_domain_name;
  1223. #endif // MIDL_PASS
  1224. } NETLOGON_INFO_4, *PNETLOGON_INFO_4;
  1225. //
  1226. // Values of netlog1_flags
  1227. //
  1228. #define NETLOGON_REPLICATION_NEEDED 0x01 // Database is out of date
  1229. #define NETLOGON_REPLICATION_IN_PROGRESS 0x02 // Replication is happening now
  1230. #define NETLOGON_FULL_SYNC_REPLICATION 0x04 // full sync replication required/progress
  1231. #define NETLOGON_REDO_NEEDED 0x08 // Redo of previous replication needed
  1232. #define NETLOGON_HAS_IP 0x10 // The trusted domain DC has an IP address
  1233. #define NETLOGON_HAS_TIMESERV 0x20 // The trusted domain DC runs the Windows Time Service
  1234. #define NETLOGON_DNS_UPDATE_FAILURE 0x40 // There was a failure in the last update for one of the DNS records
  1235. #define NETLOGON_VERIFY_STATUS_RETURNED 0x80 // Trust verification status returned in netlog2_pdc_connection_status
  1236. #ifdef __cplusplus
  1237. }
  1238. #endif
  1239. #endif // _LMDOMAIN_