99f878b84d0eabd5aa357241bc3cce81c886bfd8
[kamenim/samba.git] / source3 / lib / netapi / netapi.h
1 /*
2  *  Unix SMB/CIFS implementation.
3  *  NetApi Support
4  *  Copyright (C) Guenther Deschner 2007-2009
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 3 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef __LIB_NETAPI_H__
21 #define __LIB_NETAPI_H__
22
23 #ifdef __cplusplus
24 extern "C" {
25 #endif /* __cplusplus */
26
27 /****************************************************************
28  NET_API_STATUS
29 ****************************************************************/
30 typedef enum {
31         NET_API_STATUS_SUCCESS = 0
32 } NET_API_STATUS;
33
34 #define ERROR_MORE_DATA ( 234L )
35
36 #define ENCRYPTED_PWLEN ( 16 )
37
38 /****************************************************************
39 ****************************************************************/
40
41 #ifndef _HEADER_misc
42
43 struct GUID {
44         uint32_t time_low;
45         uint16_t time_mid;
46         uint16_t time_hi_and_version;
47         uint8_t clock_seq[2];
48         uint8_t node[6];
49 };
50
51 #endif /* _HEADER_misc */
52
53 #ifndef _HEADER_libnetapi
54
55 #ifndef MAXSUBAUTHS
56 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
57 #endif
58
59 struct domsid {
60         uint8_t   sid_rev_num;
61         uint8_t   num_auths;
62         uint8_t   id_auth[6];
63         uint32_t  sub_auths[MAXSUBAUTHS];
64 };
65
66 struct DOMAIN_CONTROLLER_INFO {
67         const char * domain_controller_name;
68         const char * domain_controller_address;
69         uint32_t domain_controller_address_type;
70         struct GUID domain_guid;
71         const char * domain_name;
72         const char * dns_forest_name;
73         uint32_t flags;
74         const char * dc_site_name;
75         const char * client_site_name;
76 };
77
78 /* bitmap NetJoinFlags */
79 #define NETSETUP_JOIN_DOMAIN ( 0x00000001 )
80 #define NETSETUP_ACCT_CREATE ( 0x00000002 )
81 #define NETSETUP_ACCT_DELETE ( 0x00000004 )
82 #define NETSETUP_WIN9X_UPGRADE ( 0x00000010 )
83 #define NETSETUP_DOMAIN_JOIN_IF_JOINED ( 0x00000020 )
84 #define NETSETUP_JOIN_UNSECURE ( 0x00000040 )
85 #define NETSETUP_MACHINE_PWD_PASSED ( 0x00000080 )
86 #define NETSETUP_DEFER_SPN_SET ( 0x00000100 )
87 #define NETSETUP_JOIN_DC_ACCOUNT ( 0x00000200 )
88 #define NETSETUP_JOIN_WITH_NEW_NAME ( 0x00000400 )
89 #define NETSETUP_INSTALL_INVOCATION ( 0x00040000 )
90 #define NETSETUP_IGNORE_UNSUPPORTED_FLAGS ( 0x10000000 )
91
92 #define FILTER_TEMP_DUPLICATE_ACCOUNT   ( 0x0001 )
93 #define FILTER_NORMAL_ACCOUNT   ( 0x0002 )
94 #define FILTER_INTERDOMAIN_TRUST_ACCOUNT        ( 0x0008 )
95 #define FILTER_WORKSTATION_TRUST_ACCOUNT        ( 0x0010 )
96 #define FILTER_SERVER_TRUST_ACCOUNT     ( 0x0020 )
97
98 #define TIMEQ_FOREVER  ( (uint32_t)-1L )
99
100 enum NETSETUP_JOIN_STATUS {
101         NetSetupUnknownStatus=0,
102         NetSetupUnjoined=1,
103         NetSetupWorkgroupName=2,
104         NetSetupDomainName=3
105 };
106
107 struct SERVER_INFO_100 {
108         uint32_t sv100_platform_id;
109         const char * sv100_name;
110 };
111
112 struct SERVER_INFO_101 {
113         uint32_t sv101_platform_id;
114         const char * sv101_name;
115         uint32_t sv101_version_major;
116         uint32_t sv101_version_minor;
117         uint32_t sv101_type;
118         const char * sv101_comment;
119 };
120
121 struct SERVER_INFO_102 {
122         uint32_t sv102_platform_id;
123         const char * sv102_name;
124         uint32_t sv102_version_major;
125         uint32_t sv102_version_minor;
126         uint32_t sv102_type;
127         const char * sv102_comment;
128         uint32_t sv102_users;
129         uint32_t sv102_disc;
130         uint8_t sv102_hidden;
131         uint32_t sv102_announce;
132         uint32_t sv102_anndelta;
133         uint32_t sv102_licenses;
134         const char * sv102_userpath;
135 };
136
137 struct SERVER_INFO_402 {
138         uint32_t sv402_ulist_mtime;
139         uint32_t sv402_glist_mtime;
140         uint32_t sv402_alist_mtime;
141         const char * sv402_alerts;
142         uint32_t sv402_security;
143         uint32_t sv402_numadmin;
144         uint32_t sv402_lanmask;
145         const char * sv402_guestacct;
146         uint32_t sv402_chdevs;
147         uint32_t sv402_chdevq;
148         uint32_t sv402_chdevjobs;
149         uint32_t sv402_connections;
150         uint32_t sv402_shares;
151         uint32_t sv402_openfiles;
152         uint32_t sv402_sessopens;
153         uint32_t sv402_sessvcs;
154         uint32_t sv402_sessreqs;
155         uint32_t sv402_opensearch;
156         uint32_t sv402_activelocks;
157         uint32_t sv402_numreqbuf;
158         uint32_t sv402_sizreqbuf;
159         uint32_t sv402_numbigbuf;
160         uint32_t sv402_numfiletasks;
161         uint32_t sv402_alertsched;
162         uint32_t sv402_erroralert;
163         uint32_t sv402_logonalert;
164         uint32_t sv402_accessalert;
165         uint32_t sv402_diskalert;
166         uint32_t sv402_netioalert;
167         uint32_t sv402_maxauditsz;
168         const char * sv402_srvheuristics;
169 };
170
171 struct SERVER_INFO_403 {
172         uint32_t sv403_ulist_mtime;
173         uint32_t sv403_glist_mtime;
174         uint32_t sv403_alist_mtime;
175         const char * sv403_alerts;
176         uint32_t sv403_security;
177         uint32_t sv403_numadmin;
178         uint32_t sv403_lanmask;
179         const char * sv403_guestacct;
180         uint32_t sv403_chdevs;
181         uint32_t sv403_chdevq;
182         uint32_t sv403_chdevjobs;
183         uint32_t sv403_connections;
184         uint32_t sv403_shares;
185         uint32_t sv403_openfiles;
186         uint32_t sv403_sessopens;
187         uint32_t sv403_sessvcs;
188         uint32_t sv403_sessreqs;
189         uint32_t sv403_opensearch;
190         uint32_t sv403_activelocks;
191         uint32_t sv403_numreqbuf;
192         uint32_t sv403_sizreqbuf;
193         uint32_t sv403_numbigbuf;
194         uint32_t sv403_numfiletasks;
195         uint32_t sv403_alertsched;
196         uint32_t sv403_erroralert;
197         uint32_t sv403_logonalert;
198         uint32_t sv403_accessalert;
199         uint32_t sv403_diskalert;
200         uint32_t sv403_netioalert;
201         uint32_t sv403_maxauditsz;
202         const char * sv403_srvheuristics;
203         uint32_t sv403_auditedevents;
204         uint32_t sv403_autoprofile;
205         const char * sv403_autopath;
206 };
207
208 struct SERVER_INFO_502 {
209         uint32_t sv502_sessopens;
210         uint32_t sv502_sessvcs;
211         uint32_t sv502_opensearch;
212         uint32_t sv502_sizreqbuf;
213         uint32_t sv502_initworkitems;
214         uint32_t sv502_maxworkitems;
215         uint32_t sv502_rawworkitems;
216         uint32_t sv502_irpstacksize;
217         uint32_t sv502_maxrawbuflen;
218         uint32_t sv502_sessusers;
219         uint32_t sv502_sessconns;
220         uint32_t sv502_maxpagedmemoryusage;
221         uint32_t sv502_maxnonpagedmemoryusage;
222         uint8_t sv502_enablesoftcompat;
223         uint8_t sv502_enableforcedlogoff;
224         uint8_t sv502_timesource;
225         uint8_t sv502_acceptdownlevelapis;
226         uint8_t sv502_lmannounce;
227 };
228
229 struct SERVER_INFO_503 {
230         uint32_t sv503_sessopens;
231         uint32_t sv503_sessvcs;
232         uint32_t sv503_opensearch;
233         uint32_t sv503_sizreqbuf;
234         uint32_t sv503_initworkitems;
235         uint32_t sv503_maxworkitems;
236         uint32_t sv503_rawworkitems;
237         uint32_t sv503_irpstacksize;
238         uint32_t sv503_maxrawbuflen;
239         uint32_t sv503_sessusers;
240         uint32_t sv503_sessconns;
241         uint32_t sv503_maxpagedmemoryusage;
242         uint32_t sv503_maxnonpagedmemoryusage;
243         uint8_t sv503_enablesoftcompat;
244         uint8_t sv503_enableforcedlogoff;
245         uint8_t sv503_timesource;
246         uint8_t sv503_acceptdownlevelapis;
247         uint8_t sv503_lmannounce;
248         const char * sv503_domain;
249         uint32_t sv503_maxcopyreadlen;
250         uint32_t sv503_maxcopywritelen;
251         uint32_t sv503_minkeepsearch;
252         uint32_t sv503_maxkeepsearch;
253         uint32_t sv503_minkeepcomplsearch;
254         uint32_t sv503_maxkeepcomplsearch;
255         uint32_t sv503_threadcountadd;
256         uint32_t sv503_numblockthreads;
257         uint32_t sv503_scavtimeout;
258         uint32_t sv503_minrcvqueue;
259         uint32_t sv503_minfreeworkitems;
260         uint32_t sv503_xactmemsize;
261         uint32_t sv503_threadpriority;
262         uint32_t sv503_maxmpxct;
263         uint32_t sv503_oplockbreakwait;
264         uint32_t sv503_oplockbreakresponsewait;
265         uint8_t sv503_enableoplocks;
266         uint8_t sv503_enableoplockforceclose;
267         uint8_t sv503_enablefcbopens;
268         uint8_t sv503_enableraw;
269         uint8_t sv503_enablesharednetdrives;
270         uint32_t sv503_minfreeconnections;
271         uint32_t sv503_maxfreeconnections;
272 };
273
274 struct SERVER_INFO_599 {
275         uint32_t sv599_sessopens;
276         uint32_t sv599_sessvcs;
277         uint32_t sv599_opensearch;
278         uint32_t sv599_sizreqbuf;
279         uint32_t sv599_initworkitems;
280         uint32_t sv599_maxworkitems;
281         uint32_t sv599_rawworkitems;
282         uint32_t sv599_irpstacksize;
283         uint32_t sv599_maxrawbuflen;
284         uint32_t sv599_sessusers;
285         uint32_t sv599_sessconns;
286         uint32_t sv599_maxpagedmemoryusage;
287         uint32_t sv599_maxnonpagedmemoryusage;
288         uint8_t sv599_enablesoftcompat;
289         uint8_t sv599_enableforcedlogoff;
290         uint8_t sv599_timesource;
291         uint8_t sv599_acceptdownlevelapis;
292         uint8_t sv599_lmannounce;
293         const char * sv599_domain;
294         uint32_t sv599_maxcopyreadlen;
295         uint32_t sv599_maxcopywritelen;
296         uint32_t sv599_minkeepsearch;
297         uint32_t sv599_maxkeepsearch;
298         uint32_t sv599_minkeepcomplsearch;
299         uint32_t sv599_maxkeepcomplsearch;
300         uint32_t sv599_threadcountadd;
301         uint32_t sv599_numblockthreads;
302         uint32_t sv599_scavtimeout;
303         uint32_t sv599_minrcvqueue;
304         uint32_t sv599_minfreeworkitems;
305         uint32_t sv599_xactmemsize;
306         uint32_t sv599_threadpriority;
307         uint32_t sv599_maxmpxct;
308         uint32_t sv599_oplockbreakwait;
309         uint32_t sv599_oplockbreakresponsewait;
310         uint8_t sv599_enableoplocks;
311         uint8_t sv599_enableoplockforceclose;
312         uint8_t sv599_enablefcbopens;
313         uint8_t sv599_enableraw;
314         uint8_t sv599_enablesharednetdrives;
315         uint32_t sv599_minfreeconnections;
316         uint32_t sv599_maxfreeconnections;
317         uint32_t sv599_initsesstable;
318         uint32_t sv599_initconntable;
319         uint32_t sv599_initfiletable;
320         uint32_t sv599_initsearchtable;
321         uint32_t sv599_alertschedule;
322         uint32_t sv599_errorthreshold;
323         uint32_t sv599_networkerrorthreshold;
324         uint32_t sv599_diskspacethreshold;
325         uint32_t sv599_reserved;
326         uint32_t sv599_maxlinkdelay;
327         uint32_t sv599_minlinkthroughput;
328         uint32_t sv599_linkinfovalidtime;
329         uint32_t sv599_scavqosinfoupdatetime;
330         uint32_t sv599_maxworkitemidletime;
331 };
332
333 struct SERVER_INFO_598 {
334         uint32_t sv598_maxrawworkitems;
335         uint32_t sv598_maxthreadsperqueue;
336         uint32_t sv598_producttype;
337         uint32_t sv598_serversize;
338         uint32_t sv598_connectionlessautodisc;
339         uint32_t sv598_sharingviolationretries;
340         uint32_t sv598_sharingviolationdelay;
341         uint32_t sv598_maxglobalopensearch;
342         uint32_t sv598_removeduplicatesearches;
343         uint32_t sv598_lockviolationoffset;
344         uint32_t sv598_lockviolationdelay;
345         uint32_t sv598_mdlreadswitchover;
346         uint32_t sv598_cachedopenlimit;
347         uint32_t sv598_otherqueueaffinity;
348         uint8_t sv598_restrictnullsessaccess;
349         uint8_t sv598_enablewfw311directipx;
350         uint32_t sv598_queuesamplesecs;
351         uint32_t sv598_balancecount;
352         uint32_t sv598_preferredaffinity;
353         uint32_t sv598_maxfreerfcbs;
354         uint32_t sv598_maxfreemfcbs;
355         uint32_t sv598_maxfreelfcbs;
356         uint32_t sv598_maxfreepagedpoolchunks;
357         uint32_t sv598_minpagedpoolchunksize;
358         uint32_t sv598_maxpagedpoolchunksize;
359         uint8_t sv598_sendsfrompreferredprocessor;
360         uint32_t sv598_cacheddirectorylimit;
361         uint32_t sv598_maxcopylength;
362         uint8_t sv598_enablecompression;
363         uint8_t sv598_autosharewks;
364         uint8_t sv598_autoshareserver;
365         uint8_t sv598_enablesecuritysignature;
366         uint8_t sv598_requiresecuritysignature;
367         uint32_t sv598_minclientbuffersize;
368         struct GUID sv598_serverguid;
369         uint32_t sv598_ConnectionNoSessionsTimeout;
370         uint32_t sv598_IdleThreadTimeOut;
371         uint8_t sv598_enableW9xsecuritysignature;
372         uint8_t sv598_enforcekerberosreauthentication;
373         uint8_t sv598_disabledos;
374         uint32_t sv598_lowdiskspaceminimum;
375         uint8_t sv598_disablestrictnamechecking;
376 };
377
378 struct SERVER_INFO_1005 {
379         const char * sv1005_comment;
380 };
381
382 struct SERVER_INFO_1107 {
383         uint32_t sv1107_users;
384 };
385
386 struct SERVER_INFO_1010 {
387         int32_t sv1010_disc;
388 };
389
390 struct SERVER_INFO_1016 {
391         uint8_t sv1016_hidden;
392 };
393
394 struct SERVER_INFO_1017 {
395         uint32_t sv1017_announce;
396 };
397
398 struct SERVER_INFO_1018 {
399         uint32_t sv1018_anndelta;
400 };
401
402 struct SERVER_INFO_1501 {
403         uint32_t sv1501_sessopens;
404 };
405
406 struct SERVER_INFO_1502 {
407         uint32_t sv1502_sessvcs;
408 };
409
410 struct SERVER_INFO_1503 {
411         uint32_t sv1503_opensearch;
412 };
413
414 struct SERVER_INFO_1506 {
415         uint32_t sv1506_maxworkitems;
416 };
417
418 struct SERVER_INFO_1509 {
419         uint32_t sv1509_maxrawbuflen;
420 };
421
422 struct SERVER_INFO_1510 {
423         uint32_t sv1510_sessusers;
424 };
425
426 struct SERVER_INFO_1511 {
427         uint32_t sv1511_sessconns;
428 };
429
430 struct SERVER_INFO_1512 {
431         uint32_t sv1512_maxnonpagedmemoryusage;
432 };
433
434 struct SERVER_INFO_1513 {
435         uint32_t sv1513_maxpagedmemoryusage;
436 };
437
438 struct SERVER_INFO_1514 {
439         uint8_t sv1514_enablesoftcompat;
440 };
441
442 struct SERVER_INFO_1515 {
443         uint8_t sv1515_enableforcedlogoff;
444 };
445
446 struct SERVER_INFO_1516 {
447         uint8_t sv1516_timesource;
448 };
449
450 struct SERVER_INFO_1518 {
451         uint8_t sv1518_lmannounce;
452 };
453
454 struct SERVER_INFO_1520 {
455         uint32_t sv1520_maxcopyreadlen;
456 };
457
458 struct SERVER_INFO_1521 {
459         uint32_t sv1521_maxcopywritelen;
460 };
461
462 struct SERVER_INFO_1522 {
463         uint32_t sv1522_minkeepsearch;
464 };
465
466 struct SERVER_INFO_1523 {
467         uint32_t sv1523_maxkeepsearch;
468 };
469
470 struct SERVER_INFO_1524 {
471         uint32_t sv1524_minkeepcomplsearch;
472 };
473
474 struct SERVER_INFO_1525 {
475         uint32_t sv1525_maxkeepcomplsearch;
476 };
477
478 struct SERVER_INFO_1528 {
479         uint32_t sv1528_scavtimeout;
480 };
481
482 struct SERVER_INFO_1529 {
483         uint32_t sv1529_minrcvqueue;
484 };
485
486 struct SERVER_INFO_1530 {
487         uint32_t sv1530_minfreeworkitems;
488 };
489
490 struct SERVER_INFO_1533 {
491         uint32_t sv1533_maxmpxct;
492 };
493
494 struct SERVER_INFO_1534 {
495         uint32_t sv1534_oplockbreakwait;
496 };
497
498 struct SERVER_INFO_1535 {
499         uint32_t sv1535_oplockbreakresponsewait;
500 };
501
502 struct SERVER_INFO_1536 {
503         uint8_t sv1536_enableoplocks;
504 };
505
506 struct SERVER_INFO_1537 {
507         uint8_t sv1537_enableoplockforceclose;
508 };
509
510 struct SERVER_INFO_1538 {
511         uint8_t sv1538_enablefcbopens;
512 };
513
514 struct SERVER_INFO_1539 {
515         uint8_t sv1539_enableraw;
516 };
517
518 struct SERVER_INFO_1540 {
519         uint8_t sv1540_enablesharednetdrives;
520 };
521
522 struct SERVER_INFO_1541 {
523         uint8_t sv1541_minfreeconnections;
524 };
525
526 struct SERVER_INFO_1542 {
527         uint8_t sv1542_maxfreeconnections;
528 };
529
530 struct SERVER_INFO_1543 {
531         uint32_t sv1543_initsesstable;
532 };
533
534 struct SERVER_INFO_1544 {
535         uint32_t sv1544_initconntable;
536 };
537
538 struct SERVER_INFO_1545 {
539         uint32_t sv1545_initfiletable;
540 };
541
542 struct SERVER_INFO_1546 {
543         uint32_t sv1546_initsearchtable;
544 };
545
546 struct SERVER_INFO_1547 {
547         uint32_t sv1547_alertschedule;
548 };
549
550 struct SERVER_INFO_1548 {
551         uint32_t sv1548_errorthreshold;
552 };
553
554 struct SERVER_INFO_1549 {
555         uint32_t sv1549_networkerrorthreshold;
556 };
557
558 struct SERVER_INFO_1550 {
559         uint32_t sv1550_diskspacethreshold;
560 };
561
562 struct SERVER_INFO_1552 {
563         uint32_t sv1552_maxlinkdelay;
564 };
565
566 struct SERVER_INFO_1553 {
567         uint32_t sv1553_minlinkthroughput;
568 };
569
570 struct SERVER_INFO_1554 {
571         uint32_t sv1554_linkinfovalidtime;
572 };
573
574 struct SERVER_INFO_1555 {
575         uint32_t sv1555_scavqosinfoupdatetime;
576 };
577
578 struct SERVER_INFO_1556 {
579         uint32_t sv1556_maxworkitemidletime;
580 };
581
582 struct SERVER_INFO_1557 {
583         uint32_t sv1557_maxrawworkitems;
584 };
585
586 struct SERVER_INFO_1560 {
587         uint32_t sv1560_producttype;
588 };
589
590 struct SERVER_INFO_1561 {
591         uint32_t sv1561_serversize;
592 };
593
594 struct SERVER_INFO_1562 {
595         uint32_t sv1562_connectionlessautodisc;
596 };
597
598 struct SERVER_INFO_1563 {
599         uint32_t sv1563_sharingviolationretries;
600 };
601
602 struct SERVER_INFO_1564 {
603         uint32_t sv1564_sharingviolationdelay;
604 };
605
606 struct SERVER_INFO_1565 {
607         uint32_t sv1565_maxglobalopensearch;
608 };
609
610 struct SERVER_INFO_1566 {
611         uint8_t sv1566_removeduplicatesearches;
612 };
613
614 struct SERVER_INFO_1567 {
615         uint32_t sv1567_lockviolationretries;
616 };
617
618 struct SERVER_INFO_1568 {
619         uint32_t sv1568_lockviolationoffset;
620 };
621
622 struct SERVER_INFO_1569 {
623         uint32_t sv1569_lockviolationdelay;
624 };
625
626 struct SERVER_INFO_1570 {
627         uint32_t sv1570_mdlreadswitchover;
628 };
629
630 struct SERVER_INFO_1571 {
631         uint32_t sv1571_cachedopenlimit;
632 };
633
634 struct SERVER_INFO_1572 {
635         uint32_t sv1572_criticalthreads;
636 };
637
638 struct SERVER_INFO_1573 {
639         uint32_t sv1573_restrictnullsessaccess;
640 };
641
642 struct SERVER_INFO_1574 {
643         uint32_t sv1574_enablewfw311directipx;
644 };
645
646 struct SERVER_INFO_1575 {
647         uint32_t sv1575_otherqueueaffinity;
648 };
649
650 struct SERVER_INFO_1576 {
651         uint32_t sv1576_queuesamplesecs;
652 };
653
654 struct SERVER_INFO_1577 {
655         uint32_t sv1577_balancecount;
656 };
657
658 struct SERVER_INFO_1578 {
659         uint32_t sv1578_preferredaffinity;
660 };
661
662 struct SERVER_INFO_1579 {
663         uint32_t sv1579_maxfreerfcbs;
664 };
665
666 struct SERVER_INFO_1580 {
667         uint32_t sv1580_maxfreemfcbs;
668 };
669
670 struct SERVER_INFO_1581 {
671         uint32_t sv1581_maxfreemlcbs;
672 };
673
674 struct SERVER_INFO_1582 {
675         uint32_t sv1582_maxfreepagedpoolchunks;
676 };
677
678 struct SERVER_INFO_1583 {
679         uint32_t sv1583_minpagedpoolchunksize;
680 };
681
682 struct SERVER_INFO_1584 {
683         uint32_t sv1584_maxpagedpoolchunksize;
684 };
685
686 struct SERVER_INFO_1585 {
687         uint8_t sv1585_sendsfrompreferredprocessor;
688 };
689
690 struct SERVER_INFO_1586 {
691         uint32_t sv1586_maxthreadsperqueue;
692 };
693
694 struct SERVER_INFO_1587 {
695         uint32_t sv1587_cacheddirectorylimit;
696 };
697
698 struct SERVER_INFO_1588 {
699         uint32_t sv1588_maxcopylength;
700 };
701
702 struct SERVER_INFO_1590 {
703         uint32_t sv1590_enablecompression;
704 };
705
706 struct SERVER_INFO_1591 {
707         uint32_t sv1591_autosharewks;
708 };
709
710 struct SERVER_INFO_1592 {
711         uint32_t sv1592_autosharewks;
712 };
713
714 struct SERVER_INFO_1593 {
715         uint32_t sv1593_enablesecuritysignature;
716 };
717
718 struct SERVER_INFO_1594 {
719         uint32_t sv1594_requiresecuritysignature;
720 };
721
722 struct SERVER_INFO_1595 {
723         uint32_t sv1595_minclientbuffersize;
724 };
725
726 struct SERVER_INFO_1596 {
727         uint32_t sv1596_ConnectionNoSessionsTimeout;
728 };
729
730 struct SERVER_INFO_1597 {
731         uint32_t sv1597_IdleThreadTimeOut;
732 };
733
734 struct SERVER_INFO_1598 {
735         uint32_t sv1598_enableW9xsecuritysignature;
736 };
737
738 struct SERVER_INFO_1599 {
739         uint8_t sv1598_enforcekerberosreauthentication;
740 };
741
742 struct SERVER_INFO_1600 {
743         uint8_t sv1598_disabledos;
744 };
745
746 struct SERVER_INFO_1601 {
747         uint32_t sv1598_lowdiskspaceminimum;
748 };
749
750 struct SERVER_INFO_1602 {
751         uint8_t sv_1598_disablestrictnamechecking;
752 };
753
754 struct USER_INFO_0 {
755         const char * usri0_name;
756 };
757
758 #define USER_PRIV_GUEST ( 0 )
759 #define USER_PRIV_USER  ( 1 )
760 #define USER_PRIV_ADMIN ( 2 )
761
762 struct USER_INFO_1 {
763         const char * usri1_name;
764         const char * usri1_password;
765         uint32_t usri1_password_age;
766         uint32_t usri1_priv;
767         const char * usri1_home_dir;
768         const char * usri1_comment;
769         uint32_t usri1_flags;
770         const char * usri1_script_path;
771 };
772
773 #define AF_OP_PRINT     ( 0x1 )
774 #define AF_OP_COMM      ( 0x2 )
775 #define AF_OP_SERVER    ( 0x4 )
776 #define AF_OP_ACCOUNTS  ( 0x8 )
777
778 struct USER_INFO_2 {
779         const char * usri2_name;
780         const char * usri2_password;
781         uint32_t usri2_password_age;
782         uint32_t usri2_priv;
783         const char * usri2_home_dir;
784         const char * usri2_comment;
785         uint32_t usri2_flags;
786         const char * usri2_script_path;
787         uint32_t usri2_auth_flags;
788         const char * usri2_full_name;
789         const char * usri2_usr_comment;
790         const char * usri2_parms;
791         const char * usri2_workstations;
792         uint32_t usri2_last_logon;
793         uint32_t usri2_last_logoff;
794         uint32_t usri2_acct_expires;
795         uint32_t usri2_max_storage;
796         uint32_t usri2_units_per_week;
797         uint8_t *usri2_logon_hours;/* [unique] */
798         uint32_t usri2_bad_pw_count;
799         uint32_t usri2_num_logons;
800         const char * usri2_logon_server;
801         uint32_t usri2_country_code;
802         uint32_t usri2_code_page;
803 };
804
805 struct USER_INFO_3 {
806         const char * usri3_name;
807         uint32_t usri3_password_age;
808         uint32_t usri3_priv;
809         const char * usri3_home_dir;
810         const char * usri3_comment;
811         uint32_t usri3_flags;
812         const char * usri3_script_path;
813         uint32_t usri3_auth_flags;
814         const char * usri3_full_name;
815         const char * usri3_usr_comment;
816         const char * usri3_parms;
817         const char * usri3_workstations;
818         uint32_t usri3_last_logon;
819         uint32_t usri3_last_logoff;
820         uint32_t usri3_acct_expires;
821         uint32_t usri3_max_storage;
822         uint32_t usri3_units_per_week;
823         uint8_t *usri3_logon_hours;/* [unique] */
824         uint32_t usri3_bad_pw_count;
825         uint32_t usri3_num_logons;
826         const char * usri3_logon_server;
827         uint32_t usri3_country_code;
828         uint32_t usri3_code_page;
829         uint32_t usri3_user_id;
830         uint32_t usri3_primary_group_id;
831         const char * usri3_profile;
832         const char * usri3_home_dir_drive;
833         uint32_t usri3_password_expired;
834 };
835
836 struct USER_INFO_4 {
837         const char * usri4_name;
838         const char * usri4_password;
839         uint32_t usri4_password_age;
840         uint32_t usri4_priv;
841         const char * usri4_home_dir;
842         const char * usri4_comment;
843         uint32_t usri4_flags;
844         const char * usri4_script_path;
845         uint32_t usri4_auth_flags;
846         const char * usri4_full_name;
847         const char * usri4_usr_comment;
848         const char * usri4_parms;
849         const char * usri4_workstations;
850         uint32_t usri4_last_logon;
851         uint32_t usri4_last_logoff;
852         uint32_t usri4_acct_expires;
853         uint32_t usri4_max_storage;
854         uint32_t usri4_units_per_week;
855         uint8_t *usri4_logon_hours;/* [unique] */
856         uint32_t usri4_bad_pw_count;
857         uint32_t usri4_num_logons;
858         const char * usri4_logon_server;
859         uint32_t usri4_country_code;
860         uint32_t usri4_code_page;
861         struct domsid *usri4_user_sid;/* [unique] */
862         uint32_t usri4_primary_group_id;
863         const char * usri4_profile;
864         const char * usri4_home_dir_drive;
865         uint32_t usri4_password_expired;
866 };
867
868 struct USER_INFO_10 {
869         const char * usri10_name;
870         const char * usri10_comment;
871         const char * usri10_usr_comment;
872         const char * usri10_full_name;
873 };
874
875 struct USER_INFO_11 {
876         const char * usri11_name;
877         const char * usri11_comment;
878         const char * usri11_usr_comment;
879         const char * usri11_full_name;
880         uint32_t usri11_priv;
881         uint32_t usri11_auth_flags;
882         uint32_t usri11_password_age;
883         const char * usri11_home_dir;
884         const char * usri11_parms;
885         uint32_t usri11_last_logon;
886         uint32_t usri11_last_logoff;
887         uint32_t usri11_bad_pw_count;
888         uint32_t usri11_num_logons;
889         const char * usri11_logon_server;
890         uint32_t usri11_country_code;
891         const char * usri11_workstations;
892         uint32_t usri11_max_storage;
893         uint32_t usri11_units_per_week;
894         uint8_t *usri11_logon_hours;/* [unique] */
895         uint32_t usri11_code_page;
896 };
897
898 struct USER_INFO_20 {
899         const char * usri20_name;
900         const char * usri20_full_name;
901         const char * usri20_comment;
902         uint32_t usri20_flags;
903         uint32_t usri20_user_id;
904 };
905
906 struct USER_INFO_21 {
907         uint8_t *usri21_password;
908 };
909
910 struct USER_INFO_22 {
911         const char * usri22_name;
912         uint8_t *usri22_password;
913         uint32_t usri22_password_age;
914         uint32_t usri22_priv;
915         const char * usri22_home_dir;
916         const char * usri22_comment;
917         uint32_t usri22_flags;
918         uint32_t usri22_script_path;
919         uint32_t usri22_auth_flags;
920         const char * usri22_full_name;
921         const char * usri22_usr_comment;
922         const char * usri22_parms;
923         const char * usri22_workstations;
924         uint32_t usri22_last_logon;
925         uint32_t usri22_last_logoff;
926         uint32_t usri22_acct_expires;
927         uint32_t usri22_max_storage;
928         uint32_t usri22_units_per_week;
929         uint8_t *usri22_logon_hours;/* [unique] */
930         uint32_t usri22_bad_pw_count;
931         uint32_t usri22_num_logons;
932         const char * usri22_logon_server;
933         uint32_t usri22_country_code;
934         uint32_t usri22_code_page;
935 };
936
937 struct USER_INFO_23 {
938         const char * usri23_name;
939         const char * usri23_full_name;
940         const char * usri23_comment;
941         uint32_t usri23_flags;
942         struct domsid *usri23_user_sid;/* [unique] */
943 };
944
945 struct USER_INFO_1003 {
946         const char * usri1003_password;
947 };
948
949 struct USER_INFO_1005 {
950         uint32_t usri1005_priv;
951 };
952
953 struct USER_INFO_1006 {
954         const char * usri1006_home_dir;
955 };
956
957 struct USER_INFO_1007 {
958         const char * usri1007_comment;
959 };
960
961 struct USER_INFO_1008 {
962         uint32_t usri1008_flags;
963 };
964
965 struct USER_INFO_1009 {
966         const char * usri1009_script_path;
967 };
968
969 struct USER_INFO_1010 {
970         uint32_t usri1010_auth_flags;
971 };
972
973 struct USER_INFO_1011 {
974         const char * usri1011_full_name;
975 };
976
977 struct USER_INFO_1012 {
978         const char * usri1012_usr_comment;
979 };
980
981 struct USER_INFO_1013 {
982         const char * usri1013_parms;
983 };
984
985 struct USER_INFO_1014 {
986         const char * usri1014_workstations;
987 };
988
989 struct USER_INFO_1017 {
990         uint32_t usri1017_acct_expires;
991 };
992
993 struct USER_INFO_1018 {
994         uint32_t usri1018_max_storage;
995 };
996
997 struct USER_INFO_1020 {
998         uint32_t usri1020_units_per_week;
999         uint8_t *usri1020_logon_hours;/* [unique] */
1000 };
1001
1002 struct USER_INFO_1023 {
1003         const char * usri1023_logon_server;
1004 };
1005
1006 struct USER_INFO_1024 {
1007         uint32_t usri1024_country_code;
1008 };
1009
1010 struct USER_INFO_1025 {
1011         uint32_t usri1025_code_page;
1012 };
1013
1014 struct USER_INFO_1051 {
1015         uint32_t usri1051_primary_group_id;
1016 };
1017
1018 struct USER_INFO_1052 {
1019         const char * usri1052_profile;
1020 };
1021
1022 struct USER_INFO_1053 {
1023         const char * usri1053_home_dir_drive;
1024 };
1025
1026 struct USER_MODALS_INFO_0 {
1027         uint32_t usrmod0_min_passwd_len;
1028         uint32_t usrmod0_max_passwd_age;
1029         uint32_t usrmod0_min_passwd_age;
1030         uint32_t usrmod0_force_logoff;
1031         uint32_t usrmod0_password_hist_len;
1032 };
1033
1034 struct USER_MODALS_INFO_1 {
1035         uint32_t usrmod1_role;
1036         const char * usrmod1_primary;
1037 };
1038
1039 struct USER_MODALS_INFO_2 {
1040         const char * usrmod2_domain_name;
1041         struct domsid *usrmod2_domain_id;/* [unique] */
1042 };
1043
1044 struct USER_MODALS_INFO_3 {
1045         uint32_t usrmod3_lockout_duration;
1046         uint32_t usrmod3_lockout_observation_window;
1047         uint32_t usrmod3_lockout_threshold;
1048 };
1049
1050 struct USER_MODALS_INFO_1001 {
1051         uint32_t usrmod1001_min_passwd_len;
1052 };
1053
1054 struct USER_MODALS_INFO_1002 {
1055         uint32_t usrmod1002_max_passwd_age;
1056 };
1057
1058 struct USER_MODALS_INFO_1003 {
1059         uint32_t usrmod1003_min_passwd_age;
1060 };
1061
1062 struct USER_MODALS_INFO_1004 {
1063         uint32_t usrmod1004_force_logoff;
1064 };
1065
1066 struct USER_MODALS_INFO_1005 {
1067         uint32_t usrmod1005_password_hist_len;
1068 };
1069
1070 struct USER_MODALS_INFO_1006 {
1071         uint32_t usrmod1006_role;
1072 };
1073
1074 struct USER_MODALS_INFO_1007 {
1075         const char * usrmod1007_primary;
1076 };
1077
1078 struct NET_DISPLAY_USER {
1079         const char * usri1_name;
1080         const char * usri1_comment;
1081         uint32_t usri1_flags;
1082         const char * usri1_full_name;
1083         uint32_t usri1_user_id;
1084         uint32_t usri1_next_index;
1085 };
1086
1087 struct NET_DISPLAY_MACHINE {
1088         const char * usri2_name;
1089         const char * usri2_comment;
1090         uint32_t usri2_flags;
1091         uint32_t usri2_user_id;
1092         uint32_t usri2_next_index;
1093 };
1094
1095 struct NET_DISPLAY_GROUP {
1096         const char * grpi3_name;
1097         const char * grpi3_comment;
1098         uint32_t grpi3_group_id;
1099         uint32_t grpi3_attributes;
1100         uint32_t grpi3_next_index;
1101 };
1102
1103 struct GROUP_INFO_0 {
1104         const char * grpi0_name;
1105 };
1106
1107 struct GROUP_INFO_1 {
1108         const char * grpi1_name;
1109         const char * grpi1_comment;
1110 };
1111
1112 struct GROUP_INFO_2 {
1113         const char * grpi2_name;
1114         const char * grpi2_comment;
1115         uint32_t grpi2_group_id;
1116         uint32_t grpi2_attributes;
1117 };
1118
1119 struct GROUP_INFO_3 {
1120         const char * grpi3_name;
1121         const char * grpi3_comment;
1122         struct domsid * grpi3_group_sid;
1123         uint32_t grpi3_attributes;
1124 };
1125
1126 struct GROUP_INFO_1002 {
1127         const char * grpi1002_comment;
1128 };
1129
1130 struct GROUP_INFO_1005 {
1131         uint32_t grpi1005_attributes;
1132 };
1133
1134 struct GROUP_USERS_INFO_0 {
1135         const char * grui0_name;
1136 };
1137
1138 struct GROUP_USERS_INFO_1 {
1139         const char * grui1_name;
1140         uint32_t grui1_attributes;
1141 };
1142
1143 struct LOCALGROUP_INFO_0 {
1144         const char * lgrpi0_name;
1145 };
1146
1147 struct LOCALGROUP_INFO_1 {
1148         const char * lgrpi1_name;
1149         const char * lgrpi1_comment;
1150 };
1151
1152 struct LOCALGROUP_INFO_1002 {
1153         const char * lgrpi1002_comment;
1154 };
1155
1156 enum SID_NAME_USE {
1157         SidTypeUser=1,
1158         SidTypeGroup=2,
1159         SidTypeDomain=3,
1160         SidTypeAlias=4,
1161         SidTypeWellKnownGroup=5,
1162         SidTypeDeletedAccount=6,
1163         SidTypeInvalid=7,
1164         SidTypeUnknown=8,
1165         SidTypeComputer=9,
1166         SidTypeLabel=10
1167 };
1168
1169 struct LOCALGROUP_MEMBERS_INFO_0 {
1170         struct domsid *lgrmi0_sid;/* [unique] */
1171 };
1172
1173 struct LOCALGROUP_MEMBERS_INFO_1 {
1174         struct domsid *lgrmi1_sid;/* [unique] */
1175         enum SID_NAME_USE lgrmi1_sidusage;
1176         const char * lgrmi1_name;
1177 };
1178
1179 struct LOCALGROUP_MEMBERS_INFO_2 {
1180         struct domsid *lgrmi2_sid;/* [unique] */
1181         enum SID_NAME_USE lgrmi2_sidusage;
1182         const char * lgrmi2_domainandname;
1183 };
1184
1185 struct LOCALGROUP_MEMBERS_INFO_3 {
1186         const char * lgrmi3_domainandname;
1187 };
1188
1189 struct LOCALGROUP_USERS_INFO_0 {
1190         const char * lgrui0_name;
1191 };
1192
1193 struct TIME_OF_DAY_INFO {
1194         uint32_t tod_elapsedt;
1195         uint32_t tod_msecs;
1196         uint32_t tod_hours;
1197         uint32_t tod_mins;
1198         uint32_t tod_secs;
1199         uint32_t tod_hunds;
1200         int32_t tod_timezone;
1201         uint32_t tod_tinterval;
1202         uint32_t tod_day;
1203         uint32_t tod_month;
1204         uint32_t tod_year;
1205         uint32_t tod_weekday;
1206 };
1207
1208 struct SHARE_INFO_0 {
1209         const char * shi0_netname;
1210 };
1211
1212 struct SHARE_INFO_1 {
1213         const char * shi1_netname;
1214         uint32_t shi1_type;
1215         const char * shi1_remark;
1216 };
1217
1218 struct SHARE_INFO_2 {
1219         const char * shi2_netname;
1220         uint32_t shi2_type;
1221         const char * shi2_remark;
1222         uint32_t shi2_permissions;
1223         uint32_t shi2_max_uses;
1224         uint32_t shi2_current_uses;
1225         const char * shi2_path;
1226         const char * shi2_passwd;
1227 };
1228
1229 struct SHARE_INFO_501 {
1230         const char * shi501_netname;
1231         uint32_t shi501_type;
1232         const char * shi501_remark;
1233         uint32_t shi501_flags;
1234 };
1235
1236 struct SHARE_INFO_1004 {
1237         const char * shi1004_remark;
1238 };
1239
1240 struct SHARE_INFO_1005 {
1241         uint32_t shi1005_flags;
1242 };
1243
1244 struct SHARE_INFO_1006 {
1245         uint32_t shi1006_max_uses;
1246 };
1247
1248 struct FILE_INFO_2 {
1249         uint32_t fi2_id;
1250 };
1251
1252 struct FILE_INFO_3 {
1253         uint32_t fi3_id;
1254         uint32_t fi3_permissions;
1255         uint32_t fi3_num_locks;
1256         const char * fi3_pathname;
1257         const char * fi3_username;
1258 };
1259
1260 struct NETLOGON_INFO_1 {
1261         uint32_t netlog1_flags;
1262         NET_API_STATUS netlog1_pdc_connection_status;
1263 };
1264
1265 struct NETLOGON_INFO_2 {
1266         uint32_t netlog2_flags;
1267         NET_API_STATUS netlog2_pdc_connection_status;
1268         const char * netlog2_trusted_dc_name;
1269         NET_API_STATUS netlog2_tc_connection_status;
1270 };
1271
1272 struct NETLOGON_INFO_3 {
1273         uint32_t netlog1_flags;
1274         uint32_t netlog3_logon_attempts;
1275         uint32_t netlog3_reserved1;
1276         uint32_t netlog3_reserved2;
1277         uint32_t netlog3_reserved3;
1278         uint32_t netlog3_reserved4;
1279         uint32_t netlog3_reserved5;
1280 };
1281
1282 struct NETLOGON_INFO_4 {
1283         const char * netlog4_trusted_dc_name;
1284         const char * netlog4_trusted_domain_name;
1285 };
1286
1287 #define DS_PDC_FLAG ( 0x00000001 )
1288 #define DS_GC_FLAG ( 0x00000004 )
1289 #define DS_LDAP_FLAG ( 0x00000008 )
1290 #define DS_DS_FLAG ( 0x00000010 )
1291 #define DS_KDC_FLAG ( 0x00000020 )
1292 #define DS_TIMESERV_FLAG ( 0x00000040 )
1293 #define DS_CLOSEST_FLAG ( 0x00000080 )
1294 #define DS_WRITABLE_FLAG ( 0x00000100 )
1295 #define DS_GOOD_TIMESERV_FLAG ( 0x00000200 )
1296 #define DS_NDNC_FLAG ( 0x00000400 )
1297 #define DS_SELECT_SECRET_DOMAIN_6_FLAG ( 0x00000800 )
1298 #define DS_FULL_SECRET_DOMAIN_6_FLAG ( 0x00001000 )
1299 #define DS_DNS_CONTROLLER_FLAG ( 0x20000000 )
1300 #define DS_DNS_DOMAIN_FLAG ( 0x40000000 )
1301 #define DS_DNS_FOREST_FLAG ( 0x80000000 )
1302
1303 #endif /* _HEADER_libnetapi */
1304
1305 #ifndef _HEADER_netlogon
1306
1307 #define NETLOGON_CONTROL_QUERY ( 0x00000001 )
1308 #define NETLOGON_CONTROL_REPLICATE ( 0x00000002 )
1309 #define NETLOGON_CONTROL_SYNCHRONIZE ( 0x00000003 )
1310 #define NETLOGON_CONTROL_PDC_REPLICATE ( 0x00000004 )
1311 #define NETLOGON_CONTROL_REDISCOVER ( 0x00000005 )
1312 #define NETLOGON_CONTROL_TC_QUERY ( 0x00000006 )
1313 #define NETLOGON_CONTROL_TRANSPORT_NOTIFY ( 0x00000007 )
1314 #define NETLOGON_CONTROL_FIND_USER ( 0x00000008 )
1315 #define NETLOGON_CONTROL_CHANGE_PASSWORD ( 0x00000009 )
1316 #define NETLOGON_CONTROL_TC_VERIFY ( 0x0000000A )
1317 #define NETLOGON_CONTROL_FORCE_DNS_REG ( 0x0000000B )
1318 #define NETLOGON_CONTROL_QUERY_DNS_REG ( 0x0000000C )
1319 #define NETLOGON_CONTROL_BACKUP_CHANGE_LOG ( 0x0000FFFC )
1320 #define NETLOGON_CONTROL_TRUNCATE_LOG ( 0x0000FFFD )
1321 #define NETLOGON_CONTROL_SET_DBFLAG ( 0x0000FFFE )
1322 #define NETLOGON_CONTROL_BREAKPOINT ( 0x0000FFFF )
1323
1324 #endif /* _HEADER_netlogon */
1325
1326 /****************************************************************
1327 ****************************************************************/
1328
1329 struct libnetapi_ctx {
1330         char *debuglevel;
1331         char *error_string;
1332         char *username;
1333         char *workgroup;
1334         char *password;
1335         char *krb5_cc_env;
1336         int use_kerberos;
1337         int use_ccache;
1338         int disable_policy_handle_cache;
1339
1340         void *private_data;
1341 };
1342
1343 /****************************************************************
1344 ****************************************************************/
1345
1346 NET_API_STATUS libnetapi_init(struct libnetapi_ctx **ctx);
1347
1348 /****************************************************************
1349 ****************************************************************/
1350
1351 NET_API_STATUS libnetapi_free(struct libnetapi_ctx *ctx);
1352
1353 /****************************************************************
1354 ****************************************************************/
1355
1356 NET_API_STATUS libnetapi_getctx(struct libnetapi_ctx **ctx);
1357
1358 /****************************************************************
1359 ****************************************************************/
1360
1361 NET_API_STATUS libnetapi_set_debuglevel(struct libnetapi_ctx *ctx,
1362                                         const char *debuglevel);
1363
1364 /****************************************************************
1365 ****************************************************************/
1366
1367 NET_API_STATUS libnetapi_set_username(struct libnetapi_ctx *ctx,
1368                                       const char *username);
1369
1370 /****************************************************************
1371 ****************************************************************/
1372
1373 NET_API_STATUS libnetapi_set_password(struct libnetapi_ctx *ctx,
1374                                       const char *password);
1375
1376 /****************************************************************
1377 ****************************************************************/
1378
1379 NET_API_STATUS libnetapi_set_workgroup(struct libnetapi_ctx *ctx,
1380                                        const char *workgroup);
1381
1382 /****************************************************************
1383 ****************************************************************/
1384
1385 NET_API_STATUS libnetapi_set_use_kerberos(struct libnetapi_ctx *ctx);
1386
1387 /****************************************************************
1388 ****************************************************************/
1389
1390 NET_API_STATUS libnetapi_set_use_ccache(struct libnetapi_ctx *ctx);
1391
1392 /****************************************************************
1393 ****************************************************************/
1394
1395 const char *libnetapi_errstr(NET_API_STATUS status);
1396
1397 /****************************************************************
1398 ****************************************************************/
1399
1400 const char *libnetapi_get_error_string(struct libnetapi_ctx *ctx,
1401                                        NET_API_STATUS status);
1402
1403 /****************************************************************
1404  NetApiBufferAllocate
1405 ****************************************************************/
1406
1407 NET_API_STATUS NetApiBufferAllocate(uint32_t byte_count,
1408                                     void **buffer);
1409
1410 /****************************************************************
1411  NetApiBufferFree
1412 ****************************************************************/
1413
1414 NET_API_STATUS NetApiBufferFree(void *buffer);
1415
1416 /************************************************************//**
1417  *
1418  * ConvertSidToStringSid
1419  *
1420  * @brief Convert a domain sid into a string
1421  *
1422  * @param[in] sid A pointer to a sid structure
1423  * @param[in,out] sid_string A pointer that holds a pointer to a sid string. Caller
1424  * needs to free with free(3)
1425  * @return bool
1426  ***************************************************************/
1427
1428 int  ConvertSidToStringSid(const struct domsid *sid,
1429                            char **sid_string);
1430
1431 /************************************************************//**
1432  *
1433  * ConvertStringSidToSid
1434  *
1435  * @brief Convert a string into a domain sid
1436  *
1437  * @param[in] sid_string A pointer to a sid string.
1438  * @param[in,out] sid A pointer that holds a pointer to a sid structure.
1439  * Caller needs to free with free(3)
1440  * @return bool
1441  ***************************************************************/
1442
1443 int ConvertStringSidToSid(const char *sid_string,
1444                           struct domsid **sid);
1445
1446 /************************************************************//**
1447  *
1448  * NetJoinDomain
1449  *
1450  * @brief Join a computer to a domain or workgroup
1451  *
1452  * @param[in] server The server name to connect to
1453  * @param[in] domain The domain or workgroup to join
1454  * @param[in] account_ou The organizational Unit to create the computer account
1455  * in (AD only)
1456  * @param[in] account The domain account used for joining a domain
1457  * @param[in] password The domain account's password used for joining a domain
1458  * @param[in] join_flags Bitmask field to define specific join features
1459  * @return NET_API_STATUS
1460  *
1461  * example netdomjoin/netdomjoin.c
1462  ***************************************************************/
1463
1464 NET_API_STATUS NetJoinDomain(const char * server /* [in] */,
1465                              const char * domain /* [in] [ref] */,
1466                              const char * account_ou /* [in] */,
1467                              const char * account /* [in] */,
1468                              const char * password /* [in] */,
1469                              uint32_t join_flags /* [in] */);
1470
1471 /************************************************************//**
1472  *
1473  * NetUnjoinDomain
1474  *
1475  * @brief Unjoin a computer from a domain or workgroup
1476  *
1477  * @param[in] server_name The server name to connect to
1478  * @param[in] account The domain account used for unjoining a domain
1479  * @param[in] password The domain account's password used for unjoining a domain
1480  * @param[in] unjoin_flags Bitmask field to define specific unjoin features
1481  * @return NET_API_STATUS
1482  *
1483  ***************************************************************/
1484
1485 NET_API_STATUS NetUnjoinDomain(const char * server_name /* [in] */,
1486                                const char * account /* [in] */,
1487                                const char * password /* [in] */,
1488                                uint32_t unjoin_flags /* [in] */);
1489
1490 /************************************************************//**
1491  *
1492  * NetGetJoinInformation
1493  *
1494  * @brief Unjoin a computer from a domain or workgroup
1495  *
1496  * @param[in] server_name The server name to connect to
1497  * @param[out] name_buffer Returns the name of the workgroup or domain
1498  * @param[out] name_type  Returns the type of that name
1499  * @return NET_API_STATUS
1500  *
1501  * example netdomjoin-gui/netdomjoin-gui.c
1502  *
1503  ***************************************************************/
1504
1505 NET_API_STATUS NetGetJoinInformation(const char * server_name /* [in] */,
1506                                      const char * *name_buffer /* [out] [ref] */,
1507                                      uint16_t *name_type /* [out] [ref] */);
1508
1509 /************************************************************//**
1510  *
1511  * NetGetJoinableOUs
1512  *
1513  * @brief Query for the list of joinable organizational Units that can be used
1514  * for joining AD
1515  *
1516  * @param[in] server_name The server name to connect to
1517  * @param[in] domain The AD domain to query
1518  * @param[in] account The domain account used for the query
1519  * @param[in] password The domain account's password used for the query
1520  * @param[out] ou_count The number of ous returned
1521  * @param[out] ous Returned string array containing the ous
1522  * @return NET_API_STATUS
1523  *
1524  * example netdomjoin-gui/netdomjoin-gui.c
1525  *
1526  ***************************************************************/
1527
1528 NET_API_STATUS NetGetJoinableOUs(const char * server_name /* [in] */,
1529                                  const char * domain /* [in] [ref] */,
1530                                  const char * account /* [in] */,
1531                                  const char * password /* [in] */,
1532                                  uint32_t *ou_count /* [out] [ref] */,
1533                                  const char * **ous /* [out] [ref] */);
1534
1535 /************************************************************//**
1536  *
1537  * NetRenameMachineInDomain
1538  *
1539  * @brief Rename a machine in a domain
1540  *
1541  * @param[in] server_name The server name to connect to
1542  * @param[in] new_machine_name The new machine name
1543  * @param[in] account The domain account used for the query
1544  * @param[in] password The domain account's password used for the query
1545  * @param[in] rename_options Options used for the rename operation
1546  * @return NET_API_STATUS
1547  *
1548  * example join/rename_machine.c
1549  *
1550  ***************************************************************/
1551
1552 NET_API_STATUS NetRenameMachineInDomain(const char * server_name /* [in] */,
1553                                         const char * new_machine_name /* [in] */,
1554                                         const char * account /* [in] */,
1555                                         const char * password /* [in] */,
1556                                         uint32_t rename_options /* [in] */);
1557
1558 /************************************************************//**
1559  *
1560  * NetServerGetInfo
1561  *
1562  * @brief Get Information on a server
1563  *
1564  * @param[in] server_name The server name to connect to
1565  * @param[in] level The level to define which information is requested
1566  * @param[out] buffer The returned buffer carrying the SERVER_INFO structure
1567  * @return NET_API_STATUS
1568  *
1569  ***************************************************************/
1570
1571 NET_API_STATUS NetServerGetInfo(const char * server_name /* [in] */,
1572                                 uint32_t level /* [in] */,
1573                                 uint8_t **buffer /* [out] [ref] */);
1574
1575 /************************************************************//**
1576  *
1577  * NetServerSetInfo
1578  *
1579  * @brief Get Information on a server
1580  *
1581  * @param[in] server_name The server name to connect to
1582  * @param[in] level The level to define which information is set
1583  * @param[in] buffer The buffer carrying the SERVER_INFO structure
1584  * @param[out] parm_error On failure returns the invalid SERVER_INFO member
1585  * @return NET_API_STATUS
1586  *
1587  ***************************************************************/
1588
1589 NET_API_STATUS NetServerSetInfo(const char * server_name /* [in] */,
1590                                 uint32_t level /* [in] */,
1591                                 uint8_t *buffer /* [in] [ref] */,
1592                                 uint32_t *parm_error /* [out] [ref] */);
1593
1594 /************************************************************//**
1595  *
1596  * NetGetDCName
1597  *
1598  * @brief Query for the PDC for a given domain
1599  *
1600  * @param[in] server_name The server name to connect to
1601  * @param[in] domain_name The name of the domain to lookup
1602  * @param[out] buffer The name of the domain to lookup
1603  * @return NET_API_STATUS
1604  *
1605  * example getdc/getdc.c
1606  ***************************************************************/
1607
1608 NET_API_STATUS NetGetDCName(const char * server_name /* [in] */,
1609                             const char * domain_name /* [in] */,
1610                             uint8_t **buffer /* [out] [ref] */);
1611
1612 /************************************************************//**
1613  *
1614  * NetGetAnyDCName
1615  *
1616  * @brief Query for any DC for a given domain
1617  *
1618  * @param[in] server_name The server name to connect to
1619  * @param[in] domain_name The name of the domain to lookup
1620  * @param[out] buffer The name of the domain to lookup
1621  * @return NET_API_STATUS
1622  *
1623  * example getdc/getdc.c
1624  ***************************************************************/
1625
1626 NET_API_STATUS NetGetAnyDCName(const char * server_name /* [in] */,
1627                                const char * domain_name /* [in] */,
1628                                uint8_t **buffer /* [out] [ref] */);
1629
1630
1631 /************************************************************//**
1632  *
1633  * DsGetDcName
1634  *
1635  * @brief Lookup a DC for a given domain and return information structure
1636  *
1637  * @param[in] server_name The server name to connect to
1638  * @param[in] domain_name The name of the domain to lookup (cannot be NULL)
1639  * @param[in] domain_guid The GUID of the domain to lookup (optional)
1640  * @param[in] site_name The name of the site the DC should reside in
1641  * @param[in] flags A bitmask to request specific features supported by the DC
1642  * @param[out] dc_info Pointer to a DOMAIN_CONTROLLER_INFO structure
1643  * @return NET_API_STATUS
1644  *
1645  * example dsgetdc/dsgetdc.c
1646  ***************************************************************/
1647
1648 NET_API_STATUS DsGetDcName(const char * server_name /* [in] [unique] */,
1649                            const char * domain_name /* [in] [ref] */,
1650                            struct GUID *domain_guid /* [in] [unique] */,
1651                            const char * site_name /* [in] [unique] */,
1652                            uint32_t flags /* [in] */,
1653                            struct DOMAIN_CONTROLLER_INFO **dc_info /* [out] [ref] */);
1654
1655 /************************************************************//**
1656  *
1657  * NetUserAdd
1658  *
1659  * @brief Create a user on a given server
1660  *
1661  * @param[in] server_name The server name to connect to
1662  * @param[in] level The level of the USER_INFO structure passed in (Currently
1663  * only level 1 is supported)
1664  * @param[in] buffer The buffer carrying the USER_INFO structure
1665  * @param[out] parm_error In case of error returns the failing member of the
1666  * structure
1667  * @return NET_API_STATUS
1668  *
1669  * example user/user_add.c
1670  ***************************************************************/
1671
1672 NET_API_STATUS NetUserAdd(const char * server_name /* [in] */,
1673                           uint32_t level /* [in] */,
1674                           uint8_t *buffer /* [in] [ref] */,
1675                           uint32_t *parm_error /* [out] [ref] */);
1676
1677 /************************************************************//**
1678  *
1679  * NetUserDel
1680  *
1681  * @brief Delete a user on a given server
1682  *
1683  * @param[in] server_name The server name to connect to
1684  * @param[in] user_name The user account to delete
1685  * @return NET_API_STATUS
1686  *
1687  * example user/user_del.c
1688  ***************************************************************/
1689
1690 NET_API_STATUS NetUserDel(const char * server_name /* [in] */,
1691                           const char * user_name /* [in] */);
1692
1693 /************************************************************//**
1694  *
1695  * NetUserEnum
1696  *
1697  * @brief Enumerate accounts on a server
1698  *
1699  * @param[in] server_name The server name to connect to
1700  * @param[in] level The enumeration level used for the query (Currently only
1701  * level 0 is supported)
1702  * @param[in] filter The account flags filter used for the query
1703  * @param[out] buffer The returned enumeration buffer
1704  * @param[in] prefmaxlen The requested maximal buffer size
1705  * @param[out] entries_read The number of returned entries
1706  * @param[out] total_entries The number of total entries
1707  * @param[in,out] resume_handle A handle passed in and returned for resuming
1708  * operations
1709  * @return NET_API_STATUS
1710  *
1711  * example user/user_enum.c
1712  ***************************************************************/
1713
1714 NET_API_STATUS NetUserEnum(const char * server_name /* [in] */,
1715                            uint32_t level /* [in] */,
1716                            uint32_t filter /* [in] */,
1717                            uint8_t **buffer /* [out] [ref] */,
1718                            uint32_t prefmaxlen /* [in] */,
1719                            uint32_t *entries_read /* [out] [ref] */,
1720                            uint32_t *total_entries /* [out] [ref] */,
1721                            uint32_t *resume_handle /* [in,out] [ref] */);
1722
1723 /************************************************************//**
1724  *
1725  * NetUserChangePassword
1726  *
1727  * @brief Change the password for a user on a given server or in a given domain
1728  *
1729  * @param[in] domain_name The server or domain name to connect to
1730  * @param[in] user_name The user account to change the password for
1731  * @param[in] old_password The user account's old password
1732  * @param[in] new_password The user account's new password
1733  * @return NET_API_STATUS
1734  *
1735  * example user/user_chgpwd.c
1736  ***************************************************************/
1737
1738 NET_API_STATUS NetUserChangePassword(const char * domain_name /* [in] */,
1739                                      const char * user_name /* [in] */,
1740                                      const char * old_password /* [in] */,
1741                                      const char * new_password /* [in] */);
1742
1743 /************************************************************//**
1744  *
1745  * NetUserGetInfo
1746  *
1747  * @brief Get User Information
1748  *
1749  * @param[in] server_name The server name to connect to
1750  * @param[in] user_name The name of the user that is going to be queried
1751  * @param[in] level The level defining the requested USER_INFO_X structure
1752  * @param[out] buffer The buffer containing a USER_INFO_X structure
1753  * @return NET_API_STATUS
1754  *
1755  * example user/user_getinfo.c
1756  ***************************************************************/
1757
1758 NET_API_STATUS NetUserGetInfo(const char * server_name /* [in] */,
1759                               const char * user_name /* [in] */,
1760                               uint32_t level /* [in] */,
1761                               uint8_t **buffer /* [out] [ref] */);
1762
1763 /************************************************************//**
1764  *
1765  * NetUserSetInfo
1766  *
1767  * @brief Set User Information
1768  *
1769  * @param[in] server_name The server name to connect to
1770  * @param[in] user_name The name of the user that is going to be modified
1771  * @param[in] level The level defining the requested USER_INFO_X structure
1772  * @param[in] buffer The buffer containing a USER_INFO_X structure
1773  * @param[out] parm_err The returned parameter error number if any
1774  * @return NET_API_STATUS
1775  *
1776  * example user/user_setinfo.c
1777  ***************************************************************/
1778
1779 NET_API_STATUS NetUserSetInfo(const char * server_name /* [in] */,
1780                               const char * user_name /* [in] */,
1781                               uint32_t level /* [in] */,
1782                               uint8_t *buffer /* [in] [ref] */,
1783                               uint32_t *parm_err /* [out] [ref] */);
1784
1785 /************************************************************//**
1786  *
1787  * NetUserModalsGet
1788  *
1789  * @brief Get SAM domain and password information
1790  *
1791  * @param[in] server_name The server name to connect to
1792  * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1793  * @param[out] buffer The returned USER_MODALS_INFO_X buffer
1794  * @return NET_API_STATUS
1795  *
1796  * example user/user_modalsget.c
1797  ***************************************************************/
1798
1799 NET_API_STATUS NetUserModalsGet(const char * server_name /* [in] */,
1800                                 uint32_t level /* [in] */,
1801                                 uint8_t **buffer /* [out] [ref] */);
1802
1803 /************************************************************//**
1804  *
1805  * NetUserModalsSet
1806  *
1807  * @brief Set SAM domain and password information
1808  *
1809  * @param[in] server_name The server name to connect to
1810  * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1811  * @param[out] buffer The buffer conntaing a USER_MODALS_INFO_X structure
1812  * @param[out] parm_err The returned parameter error number if any
1813  * @return NET_API_STATUS
1814  *
1815  * example user/user_modalsset.c
1816  ***************************************************************/
1817
1818 NET_API_STATUS NetUserModalsSet(const char * server_name /* [in] */,
1819                                 uint32_t level /* [in] */,
1820                                 uint8_t *buffer /* [in] [ref] */,
1821                                 uint32_t *parm_err /* [out] [ref] */);
1822
1823 /************************************************************//**
1824  *
1825  * NetUserGetGroups
1826  *
1827  * @brief Enumerate grouplist of a user on a server
1828  *
1829  * @param[in] server_name The server name to connect to
1830  * @param[in] user_name The user name to query
1831  * @param[in] level The enumeration level used for the query (Currently only
1832  * level 0 is supported)
1833  * @param[out] buffer The returned enumeration buffer
1834  * @param[in] prefmaxlen The requested maximal buffer size
1835  * @param[out] entries_read The number of returned entries
1836  * @param[out] total_entries The number of total entries
1837  * @return NET_API_STATUS
1838  *
1839  * example user/user_getgroups.c
1840  ***************************************************************/
1841
1842 NET_API_STATUS NetUserGetGroups(const char * server_name /* [in] */,
1843                                 const char * user_name /* [in] */,
1844                                 uint32_t level /* [in] */,
1845                                 uint8_t **buffer /* [out] [ref] */,
1846                                 uint32_t prefmaxlen /* [in] */,
1847                                 uint32_t *entries_read /* [out] [ref] */,
1848                                 uint32_t *total_entries /* [out] [ref] */);
1849
1850 /************************************************************//**
1851  *
1852  * NetUserSetGroups
1853  *
1854  * @brief Set grouplist of a user on a server
1855  *
1856  * @param[in] server_name The server name to connect to
1857  * @param[in] user_name The user name to query
1858  * @param[in] level The level defining the GROUP_USERS_INFO_X structures in the buffer
1859  * @param[in] buffer The buffer containing GROUP_USERS_INFO_X structures
1860  * @param[in] num_entries The number of X structures in the buffer
1861  * @return NET_API_STATUS
1862  *
1863  * example user/user_setgroups.c
1864  ***************************************************************/
1865
1866 NET_API_STATUS NetUserSetGroups(const char * server_name /* [in] */,
1867                                 const char * user_name /* [in] */,
1868                                 uint32_t level /* [in] */,
1869                                 uint8_t *buffer /* [in] [ref] */,
1870                                 uint32_t num_entries /* [in] */);
1871
1872 /************************************************************//**
1873  *
1874  * NetUserGetLocalGroups
1875  *
1876  * @brief Enumerate local grouplist of a user on a server
1877  *
1878  * @param[in] server_name The server name to connect to
1879  * @param[in] user_name The user name to query
1880  * @param[in] level The enumeration level used for the query
1881  * @param[in] flags The flags used for the query
1882  * @param[out] buffer The returned enumeration buffer
1883  * @param[in] prefmaxlen The requested maximal buffer size
1884  * @param[out] entries_read The number of returned entries
1885  * @param[out] total_entries The number of total entries
1886  * @return NET_API_STATUS
1887  *
1888  * example user/user_getlocalgroups.c
1889  ***************************************************************/
1890
1891 NET_API_STATUS NetUserGetLocalGroups(const char * server_name /* [in] */,
1892                                      const char * user_name /* [in] */,
1893                                      uint32_t level /* [in] */,
1894                                      uint32_t flags /* [in] */,
1895                                      uint8_t **buffer /* [out] [ref] */,
1896                                      uint32_t prefmaxlen /* [in] */,
1897                                      uint32_t *entries_read /* [out] [ref] */,
1898                                      uint32_t *total_entries /* [out] [ref] */);
1899
1900 /************************************************************//**
1901  *
1902  * NetQueryDisplayInformation
1903  *
1904  * @brief Enumerate accounts on a server
1905  *
1906  * @param[in] server_name The server name to connect to
1907  * @param[in] level The enumeration level used for the query
1908  * @param[in] idx The index to start the the display enumeration at
1909  * @param[in] entries_requested The number of entries requested
1910  * @param[in] prefmaxlen The requested maximal buffer size
1911  * @param[out] entries_read The number of returned entries
1912  * @param[out] buffer The returned display information buffer
1913  * @return NET_API_STATUS
1914  *
1915  * example user/user_dispinfo.c
1916  ***************************************************************/
1917
1918 NET_API_STATUS NetQueryDisplayInformation(const char * server_name /* [in] [unique] */,
1919                                           uint32_t level /* [in] */,
1920                                           uint32_t idx /* [in] */,
1921                                           uint32_t entries_requested /* [in] */,
1922                                           uint32_t prefmaxlen /* [in] */,
1923                                           uint32_t *entries_read /* [out] [ref] */,
1924                                           void **buffer /* [out] [noprint,ref] */);
1925
1926 /************************************************************//**
1927  *
1928  * NetGroupAdd
1929  *
1930  * @brief Create Domain Group
1931  *
1932  * @param[in] server_name The server name to connect to
1933  * @param[in] level The level used for the new group creation
1934  * @param[in] buf The buffer containing the group structure
1935  * @param[out] parm_err The returned parameter error number if any
1936  * @return NET_API_STATUS
1937  *
1938  * example group/group_add.c
1939  ***************************************************************/
1940
1941 NET_API_STATUS NetGroupAdd(const char * server_name /* [in] */,
1942                            uint32_t level /* [in] */,
1943                            uint8_t *buf /* [in] [ref] */,
1944                            uint32_t *parm_err /* [out] [ref] */);
1945
1946 /************************************************************//**
1947  *
1948  * NetGroupDel
1949  *
1950  * @brief Delete Domain Group
1951  *
1952  * @param[in] server_name The server name to connect to
1953  * @param[in] group_name The name of the group that is going to be deleted
1954  * @return NET_API_STATUS
1955  *
1956  * example group/group_del.c
1957  ***************************************************************/
1958
1959 NET_API_STATUS NetGroupDel(const char * server_name /* [in] */,
1960                            const char * group_name /* [in] */);
1961
1962 /************************************************************//**
1963  *
1964  * NetGroupEnum
1965  *
1966  * @brief Enumerate groups on a server
1967  *
1968  * @param[in] server_name The server name to connect to
1969  * @param[in] level The enumeration level used for the query (Currently only
1970  * level 0 is supported)
1971  * @param[out] buffer The returned enumeration buffer
1972  * @param[in] prefmaxlen The requested maximal buffer size
1973  * @param[out] entries_read The number of returned entries
1974  * @param[out] total_entries The number of total entries
1975  * @param[in,out] resume_handle A handle passed in and returned for resuming
1976  * operations
1977  * @return NET_API_STATUS
1978  *
1979  * example group/group_enum.c
1980  ***************************************************************/
1981
1982 NET_API_STATUS NetGroupEnum(const char * server_name /* [in] */,
1983                             uint32_t level /* [in] */,
1984                             uint8_t **buffer /* [out] [ref] */,
1985                             uint32_t prefmaxlen /* [in] */,
1986                             uint32_t *entries_read /* [out] [ref] */,
1987                             uint32_t *total_entries /* [out] [ref] */,
1988                             uint32_t *resume_handle /* [in,out] [ref] */);
1989
1990 /************************************************************//**
1991  *
1992  * NetGroupSetInfo
1993  *
1994  * @brief Set Domain Group Information
1995  *
1996  * @param[in] server_name The server name to connect to
1997  * @param[in] group_name The name of the group that is going to be modified
1998  * @param[in] level The level defining the structure type in buf
1999  * @param[in] buf The buffer containing a GROUP_INFO_X structure
2000  * @param[out] parm_err The returned parameter error number if any
2001  * @return NET_API_STATUS
2002  *
2003  * example group/group_setinfo.c
2004  ***************************************************************/
2005
2006 NET_API_STATUS NetGroupSetInfo(const char * server_name /* [in] */,
2007                                const char * group_name /* [in] */,
2008                                uint32_t level /* [in] */,
2009                                uint8_t *buf /* [in] [ref] */,
2010                                uint32_t *parm_err /* [out] [ref] */);
2011
2012 /************************************************************//**
2013  *
2014  * NetGroupGetInfo
2015  *
2016  * @brief Get Domain Group Information
2017  *
2018  * @param[in] server_name The server name to connect to
2019  * @param[in] group_name The name of the group that is going to be queried
2020  * @param[in] level The level defining the requested GROUP_INFO_X structure
2021  * @param[out] buf The buffer containing a GROUP_INFO_X structure
2022  * @return NET_API_STATUS
2023  *
2024  * example group/group_getinfo.c
2025  ***************************************************************/
2026
2027 NET_API_STATUS NetGroupGetInfo(const char * server_name /* [in] */,
2028                                const char * group_name /* [in] */,
2029                                uint32_t level /* [in] */,
2030                                uint8_t **buf /* [out] [ref] */);
2031
2032 /************************************************************//**
2033  *
2034  * NetGroupAddUser
2035  *
2036  * @brief Add existing User to existing Domain Group
2037  *
2038  * @param[in] server_name The server name to connect to
2039  * @param[in] group_name The name of the group that is going to be modified
2040  * @param[in] user_name The name of the user that is going to be added to the
2041  * group
2042  * @return NET_API_STATUS
2043  *
2044  * example group/group_adduser.c
2045  ***************************************************************/
2046
2047 NET_API_STATUS NetGroupAddUser(const char * server_name /* [in] */,
2048                                const char * group_name /* [in] */,
2049                                const char * user_name /* [in] */);
2050
2051 /************************************************************//**
2052  *
2053  * NetGroupDelUser
2054  *
2055  * @brief Remove User from Domain Group
2056  *
2057  * @param[in] server_name The server name to connect to
2058  * @param[in] group_name The name of the group that is going to be modified
2059  * @param[in] user_name The name of the user that is going to be removed from
2060  * the group
2061  * @return NET_API_STATUS
2062  *
2063  * example group/group_deluser.c
2064  ***************************************************************/
2065
2066 NET_API_STATUS NetGroupDelUser(const char * server_name /* [in] */,
2067                                const char * group_name /* [in] */,
2068                                const char * user_name /* [in] */);
2069
2070 /************************************************************//**
2071  *
2072  * NetGroupGetUsers
2073  *
2074  * @brief Get Users for a group on a server
2075  *
2076  * @param[in] server_name The server name to connect to
2077  * @param[in] group_name The group name to enumerate users for
2078  * @param[in] level The enumeration level used for the query
2079  * @param[out] buffer The returned enumeration buffer
2080  * @param[in] prefmaxlen The requested maximal buffer size
2081  * @param[out] entries_read The number of returned entries
2082  * @param[out] total_entries The number of total entries
2083  * @param[in,out] resume_handle A handle passed in and returned for resuming
2084  * operations
2085  * @return NET_API_STATUS
2086  *
2087  * example group/group_getusers.c
2088  ***************************************************************/
2089
2090 NET_API_STATUS NetGroupGetUsers(const char * server_name /* [in] */,
2091                                 const char * group_name /* [in] */,
2092                                 uint32_t level /* [in] */,
2093                                 uint8_t **buffer /* [out] [ref] */,
2094                                 uint32_t prefmaxlen /* [in] */,
2095                                 uint32_t *entries_read /* [out] [ref] */,
2096                                 uint32_t *total_entries /* [out] [ref] */,
2097                                 uint32_t *resume_handle /* [in,out] [ref] */);
2098
2099 /************************************************************//**
2100  *
2101  * NetGroupSetUsers
2102  *
2103  * @brief Set Users for a group on a server
2104  *
2105  * @param[in] server_name The server name to connect to
2106  * @param[in] group_name The group name to enumerate users for
2107  * @param[in] level The enumeration level used for the query
2108  * @param[in] buffer The buffer containing a X structure
2109  * @param[in] num_entries The number of X entries in the buffer
2110  * @return NET_API_STATUS
2111  *
2112  * example group/group_setusers.c
2113  ***************************************************************/
2114
2115 NET_API_STATUS NetGroupSetUsers(const char * server_name /* [in] */,
2116                                 const char * group_name /* [in] */,
2117                                 uint32_t level /* [in] */,
2118                                 uint8_t *buffer /* [in] [ref] */,
2119                                 uint32_t num_entries /* [in] */);
2120
2121 /************************************************************//**
2122  *
2123  * NetLocalGroupAdd
2124  *
2125  * @brief Create Local Group
2126  *
2127  * @param[in] server_name The server name to connect to
2128  * @param[in] level The level used for the new group creation
2129  * @param[in] buf The buffer containing the group structure
2130  * @param[out] parm_err The returned parameter error number if any
2131  * @return NET_API_STATUS
2132  *
2133  * example localgroup/localgroup_add.c
2134  ***************************************************************/
2135
2136 NET_API_STATUS NetLocalGroupAdd(const char * server_name /* [in] */,
2137                                 uint32_t level /* [in] */,
2138                                 uint8_t *buf /* [in] [ref] */,
2139                                 uint32_t *parm_err /* [out] [ref] */);
2140
2141 /************************************************************//**
2142  *
2143  * NetLocalGroupDel
2144  *
2145  * @brief Delete Local Group
2146  *
2147  * @param[in] server_name The server name to connect to
2148  * @param[in] group_name The name of the group that is going to be deleted
2149  * @return NET_API_STATUS
2150  *
2151  * example localgroup/localgroup_del.c
2152  ***************************************************************/
2153
2154
2155 NET_API_STATUS NetLocalGroupDel(const char * server_name /* [in] */,
2156                                 const char * group_name /* [in] */);
2157
2158 /************************************************************//**
2159  *
2160  * NetLocalGroupGetInfo
2161  *
2162  * @brief Get Local Group Information
2163  *
2164  * @param[in] server_name The server name to connect to
2165  * @param[in] group_name The name of the group that is going to be queried
2166  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2167  * @param[out] buf The buffer containing a LOCALGROUP_INFO_X structure
2168  * @return NET_API_STATUS
2169  *
2170  * example localgroup/localgroup_getinfo.c
2171  ***************************************************************/
2172
2173 NET_API_STATUS NetLocalGroupGetInfo(const char * server_name /* [in] */,
2174                                     const char * group_name /* [in] */,
2175                                     uint32_t level /* [in] */,
2176                                     uint8_t **buf /* [out] [ref] */);
2177
2178 /************************************************************//**
2179  *
2180  * NetLocalGroupSetInfo
2181  *
2182  * @brief Set Local Group Information
2183  *
2184  * @param[in] server_name The server name to connect to
2185  * @param[in] group_name The name of the group that is going to be modified
2186  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2187  * @param[in] buf The buffer containing a LOCALGROUP_INFO_X structure
2188  * @param[out] parm_err The returned parameter error number if any
2189  * @return NET_API_STATUS
2190  *
2191  * example localgroup/localgroup_setinfo.c
2192  ***************************************************************/
2193
2194
2195 NET_API_STATUS NetLocalGroupSetInfo(const char * server_name /* [in] */,
2196                                     const char * group_name /* [in] */,
2197                                     uint32_t level /* [in] */,
2198                                     uint8_t *buf /* [in] [ref] */,
2199                                     uint32_t *parm_err /* [out] [ref] */);
2200
2201 /************************************************************//**
2202  *
2203  * NetLocalGroupEnum
2204  *
2205  * @brief Enumerate local groups on a server
2206  *
2207  * @param[in] server_name The server name to connect to
2208  * @param[in] level The enumeration level used for the query (Currently only
2209  * level 0 is supported)
2210  * @param[out] buffer The returned enumeration buffer
2211  * @param[in] prefmaxlen The requested maximal buffer size
2212  * @param[out] entries_read The number of returned entries
2213  * @param[out] total_entries The number of total entries
2214  * @param[in,out] resume_handle A handle passed in and returned for resuming
2215  * operations
2216  * @return NET_API_STATUS
2217  *
2218  * example localgroup/localgroup_enum.c
2219  ***************************************************************/
2220
2221 NET_API_STATUS NetLocalGroupEnum(const char * server_name /* [in] */,
2222                                  uint32_t level /* [in] */,
2223                                  uint8_t **buffer /* [out] [ref] */,
2224                                  uint32_t prefmaxlen /* [in] */,
2225                                  uint32_t *entries_read /* [out] [ref] */,
2226                                  uint32_t *total_entries /* [out] [ref] */,
2227                                  uint32_t *resume_handle /* [in,out] [ref] */);
2228
2229 /************************************************************//**
2230  *
2231  * NetLocalGroupAddMembers
2232  *
2233  * @brief Add Members to a Local Group
2234  *
2235  * @param[in] server_name The server name to connect to
2236  * @param[in] group_name The name of the group that is going to modified
2237  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2238  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2239  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2240  * the buffer
2241  * @return NET_API_STATUS
2242  *
2243  * example localgroup/localgroup_addmembers.c
2244  ***************************************************************/
2245
2246 NET_API_STATUS NetLocalGroupAddMembers(const char * server_name /* [in] */,
2247                                        const char * group_name /* [in] */,
2248                                        uint32_t level /* [in] */,
2249                                        uint8_t *buffer /* [in] [ref] */,
2250                                        uint32_t total_entries /* [in] */);
2251
2252 /************************************************************//**
2253  *
2254  * NetLocalGroupDelMembers
2255  *
2256  * @brief Delete Members from a Local Group
2257  *
2258  * @param[in] server_name The server name to connect to
2259  * @param[in] group_name The name of the group that is going to modified
2260  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2261  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2262  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2263  * the buffer
2264  * @return NET_API_STATUS
2265  *
2266  * example localgroup/localgroup_delmembers.c
2267  ***************************************************************/
2268
2269 NET_API_STATUS NetLocalGroupDelMembers(const char * server_name /* [in] */,
2270                                        const char * group_name /* [in] */,
2271                                        uint32_t level /* [in] */,
2272                                        uint8_t *buffer /* [in] [ref] */,
2273                                        uint32_t total_entries /* [in] */);
2274
2275 /************************************************************//**
2276  *
2277  * NetLocalGroupGetMembers
2278  *
2279  * @brief Enumerate Members in a local group
2280  *
2281  * @param[in] server_name The server name to connect to
2282  * @param[in] local_group_name The localgroup that is going to be queried
2283  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2284  * @param[out] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X
2285  * structure
2286  * @param[in] prefmaxlen The requested maximal buffer size
2287  * @param[out] entries_read The number of LOCALGROUP_MEMBERS_INFO_X entries in the buffer
2288  * @param[out] total_entries The total number of LOCALGROUP_MEMBERS_INFO_X entries for that group
2289  * @param[in,out] resume_handle A handle passed in and returned for resuming
2290  * operations
2291  * @return NET_API_STATUS
2292  *
2293  * example localgroup/localgroup_getmembers.c
2294  ***************************************************************/
2295
2296 NET_API_STATUS NetLocalGroupGetMembers(const char * server_name /* [in] */,
2297                                        const char * local_group_name /* [in] */,
2298                                        uint32_t level /* [in] */,
2299                                        uint8_t **buffer /* [out] [ref] */,
2300                                        uint32_t prefmaxlen /* [in] */,
2301                                        uint32_t *entries_read /* [out] [ref] */,
2302                                        uint32_t *total_entries /* [out] [ref] */,
2303                                        uint32_t *resume_handle /* [in,out] [ref] */);
2304
2305 /************************************************************//**
2306  *
2307  * NetLocalGroupSetMembers
2308  *
2309  * @brief Set Members in a Local Group
2310  *
2311  * @param[in] server_name The server name to connect to
2312  * @param[in] group_name The name of the group that is going to modified
2313  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2314  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2315  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2316  * the buffer
2317  * @return NET_API_STATUS
2318  *
2319  * example localgroup/localgroup_setmembers.c
2320  ***************************************************************/
2321
2322 NET_API_STATUS NetLocalGroupSetMembers(const char * server_name /* [in] */,
2323                                        const char * group_name /* [in] */,
2324                                        uint32_t level /* [in] */,
2325                                        uint8_t *buffer /* [in] [ref] */,
2326                                        uint32_t total_entries /* [in] */);
2327
2328 /************************************************************//**
2329  *
2330  * NetRemoteTOD
2331  *
2332  * @brief Query remote Time of Day
2333  *
2334  * @param[in] server_name The server name to connect to
2335  * @param[out] buf The buffer containing a TIME_OF_DAY_INFO structure
2336  * @return NET_API_STATUS
2337  *
2338  * example server/remote_tod.c
2339  ***************************************************************/
2340
2341 NET_API_STATUS NetRemoteTOD(const char * server_name /* [in] */,
2342                             uint8_t **buf /* [out] [ref] */);
2343
2344 /************************************************************//**
2345  *
2346  * NetShareAdd
2347  *
2348  * @brief Add Share
2349  *
2350  * @param[in] server_name The server name to connect to
2351  * @param[in] level The level defining the requested SHARE_INFO_X structure
2352  * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2353  * @param[out] parm_err The returned parameter error number if any
2354  * @return NET_API_STATUS
2355  *
2356  * example share/share_add.c
2357  ***************************************************************/
2358
2359 NET_API_STATUS NetShareAdd(const char * server_name /* [in] */,
2360                            uint32_t level /* [in] */,
2361                            uint8_t *buffer /* [in] [ref] */,
2362                            uint32_t *parm_err /* [out] [ref] */);
2363
2364 /************************************************************//**
2365  *
2366  * NetShareDel
2367  *
2368  * @brief Delete Share
2369  *
2370  * @param[in] server_name The server name to connect to
2371  * @param[in] net_name The name of the share to delete
2372  * @param[in] reserved
2373  * @return NET_API_STATUS
2374  *
2375  * example share/share_del.c
2376  ***************************************************************/
2377
2378 NET_API_STATUS NetShareDel(const char * server_name /* [in] */,
2379                            const char * net_name /* [in] */,
2380                            uint32_t reserved /* [in] */);
2381
2382 /************************************************************//**
2383  *
2384  * NetShareEnum
2385  *
2386  * @brief Enumerate Shares
2387  *
2388  * @param[in] server_name The server name to connect to
2389  * @param[in] level The level defining the SHARE_INFO_X structure
2390  * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2391  * @param[in] prefmaxlen The requested maximal buffer size
2392  * @param[out] entries_read The number of SHARE_INFO_X entries in the buffer
2393  * @param[out] total_entries The total number of SHARE_INFO_X entries
2394  * @param[in,out] resume_handle A handle passed in and returned for resuming
2395  * operations
2396  * @return NET_API_STATUS
2397  *
2398  * example share/share_enum.c
2399  ***************************************************************/
2400
2401 NET_API_STATUS NetShareEnum(const char * server_name /* [in] */,
2402                             uint32_t level /* [in] */,
2403                             uint8_t **buffer /* [out] [ref] */,
2404                             uint32_t prefmaxlen /* [in] */,
2405                             uint32_t *entries_read /* [out] [ref] */,
2406                             uint32_t *total_entries /* [out] [ref] */,
2407                             uint32_t *resume_handle /* [in,out] [ref] */);
2408
2409 /************************************************************//**
2410  *
2411  * NetShareGetInfo
2412  *
2413  * @brief Get Share Info
2414  *
2415  * @param[in] server_name The server name to connect to
2416  * @param[in] net_name The name of the share to query
2417  * @param[in] level The level defining the SHARE_INFO_X structure
2418  * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2419  * @return NET_API_STATUS
2420  *
2421  * example share/share_getinfo.c
2422  ***************************************************************/
2423
2424 NET_API_STATUS NetShareGetInfo(const char * server_name /* [in] */,
2425                                const char * net_name /* [in] */,
2426                                uint32_t level /* [in] */,
2427                                uint8_t **buffer /* [out] [ref] */);
2428
2429 /************************************************************//**
2430  *
2431  * NetShareSetInfo
2432  *
2433  * @brief Set Share Info
2434  *
2435  * @param[in] server_name The server name to connect to
2436  * @param[in] net_name The name of the share to query
2437  * @param[in] level The level defining the SHARE_INFO_X structure
2438  * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2439  * @param[out] parm_err The returned parameter error number if any
2440  * @return NET_API_STATUS
2441  *
2442  * example share/share_setinfo.c
2443  ***************************************************************/
2444
2445 NET_API_STATUS NetShareSetInfo(const char * server_name /* [in] */,
2446                                const char * net_name /* [in] */,
2447                                uint32_t level /* [in] */,
2448                                uint8_t *buffer /* [in] [ref] */,
2449                                uint32_t *parm_err /* [out] [ref] */);
2450
2451 /************************************************************//**
2452  *
2453  * NetFileClose
2454  *
2455  * @brief Close a file
2456  *
2457  * @param[in] server_name The server name to connect to
2458  * @param[in] fileid The fileid of the file that is going to be closed
2459  * @return NET_API_STATUS
2460  *
2461  * example file/file_close.c
2462  ***************************************************************/
2463
2464 NET_API_STATUS NetFileClose(const char * server_name /* [in] */,
2465                             uint32_t fileid /* [in] */);
2466
2467 /************************************************************//**
2468  *
2469  * NetFileGetInfo
2470  *
2471  * @brief Close a file
2472  *
2473  * @param[in] server_name The server name to connect to
2474  * @param[in] fileid The fileid of the file that is going to be closed
2475  * @param[in] level The level of the FILE_INFO_X buffer
2476  * @param[out] buffer The buffer containing a FILE_INFO_X structure
2477  * @return NET_API_STATUS
2478  *
2479  * example file/file_getinfo.c
2480  ***************************************************************/
2481
2482 NET_API_STATUS NetFileGetInfo(const char * server_name /* [in] */,
2483                               uint32_t fileid /* [in] */,
2484                               uint32_t level /* [in] */,
2485                               uint8_t **buffer /* [out] [ref] */);
2486
2487 /************************************************************//**
2488  *
2489  * NetFileEnum
2490  *
2491  * @brief Enumerate Files
2492  *
2493  * @param[in] server_name The server name to connect to
2494  * @param[in] base_path The
2495  * @param[in] user_name The
2496  * @param[in] level The level defining the FILE_INFO_X structure
2497  * @param[out] buffer The buffer containing a FILE_INFO_X structure
2498  * @param[in] prefmaxlen The requested maximal buffer size
2499  * @param[out] entries_read The number of FILE_INFO_X entries in the buffer
2500  * @param[out] total_entries The total number of FILE_INFO_X entries
2501  * @param[in,out] resume_handle A handle passed in and returned for resuming
2502  * operations
2503  * @return NET_API_STATUS
2504  *
2505  * example file/file_enum.c
2506  ***************************************************************/
2507
2508 NET_API_STATUS NetFileEnum(const char * server_name /* [in] */,
2509                            const char * base_path /* [in] */,
2510                            const char * user_name /* [in] */,
2511                            uint32_t level /* [in] */,
2512                            uint8_t **buffer /* [out] [ref] */,
2513                            uint32_t prefmaxlen /* [in] */,
2514                            uint32_t *entries_read /* [out] [ref] */,
2515                            uint32_t *total_entries /* [out] [ref] */,
2516                            uint32_t *resume_handle /* [in,out] [ref] */);
2517
2518 /************************************************************//**
2519  *
2520  * NetShutdownInit
2521  *
2522  * @brief Start a machine shutdown
2523  *
2524  * @param[in] server_name The server name to connect to
2525  * @param[in] message The message that is displayed before the shutdown
2526  * @param[in] timeout The amount of seconds to wait until shutting down
2527  * @param[in] force_apps Whether to close all applications before the shutdown
2528  * @param[in] do_reboot Whether to reboot after the shutdown
2529  * @return NET_API_STATUS
2530  *
2531  * example shutdown/shutdown_init.c
2532  ***************************************************************/
2533
2534 NET_API_STATUS NetShutdownInit(const char * server_name /* [in] */,
2535                                const char * message /* [in] */,
2536                                uint32_t timeout /* [in] */,
2537                                uint8_t force_apps /* [in] */,
2538                                uint8_t do_reboot /* [in] */);
2539
2540 /************************************************************//**
2541  *
2542  * NetShutdownAbort
2543  *
2544  * @brief Abort an initiated machine shutdown
2545  *
2546  * @param[in] server_name The server name to connect to
2547  * @return NET_API_STATUS
2548  *
2549  * example shutdown/shutdown_abort.c
2550  ***************************************************************/
2551
2552 NET_API_STATUS NetShutdownAbort(const char * server_name /* [in] */);
2553
2554 /************************************************************//**
2555  *
2556  * I_NetLogonControl
2557  *
2558  * @brief Control various aspects of the NETLOGON service
2559  *
2560  * @param[in] server_name The server name to connect to
2561  * @param[in] function_code The function code to call on the server
2562  * @param[in] query_level The level of the NETLOGON_INFO structure returned
2563  * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2564  * @return NET_API_STATUS
2565  *
2566  * example netlogon/netlogon_control.c
2567  ***************************************************************/
2568
2569 NET_API_STATUS I_NetLogonControl(const char * server_name /* [in] */,
2570                                  uint32_t function_code /* [in] */,
2571                                  uint32_t query_level /* [in] */,
2572                                  uint8_t **buffer /* [out] [ref] */);
2573
2574 /************************************************************//**
2575  *
2576  * I_NetLogonControl2
2577  *
2578  * @brief Control various aspects of the NETLOGON service
2579  *
2580  * @param[in] server_name The server name to connect to
2581  * @param[in] function_code The function code to call on the server
2582  * @param[in] query_level The level of the NETLOGON_INFO structure returned
2583  * @param[in] data The buffer containing information related to the function code
2584  * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2585  * @return NET_API_STATUS
2586  *
2587  * example netlogon/netlogon_control2.c
2588  ***************************************************************/
2589
2590 NET_API_STATUS I_NetLogonControl2(const char * server_name /* [in] */,
2591                                   uint32_t function_code /* [in] */,
2592                                   uint32_t query_level /* [in] */,
2593                                   uint8_t *data /* [in] [ref] */,
2594                                   uint8_t **buffer /* [out] [ref] */);
2595
2596 #ifdef __cplusplus
2597 }
2598 #endif /* __cplusplus */
2599
2600 #endif /* __LIB_NETAPI_H__ */