]> git.samba.org - mat/samba.git/blob - source3/lib/netapi/netapi.h
s3: add libnetapi_set_use_ccache()
[mat/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 #endif /* _HEADER_libnetapi */
1288
1289 #ifndef _HEADER_netlogon
1290
1291 #define NETLOGON_CONTROL_QUERY ( 0x00000001 )
1292 #define NETLOGON_CONTROL_REPLICATE ( 0x00000002 )
1293 #define NETLOGON_CONTROL_SYNCHRONIZE ( 0x00000003 )
1294 #define NETLOGON_CONTROL_PDC_REPLICATE ( 0x00000004 )
1295 #define NETLOGON_CONTROL_REDISCOVER ( 0x00000005 )
1296 #define NETLOGON_CONTROL_TC_QUERY ( 0x00000006 )
1297 #define NETLOGON_CONTROL_TRANSPORT_NOTIFY ( 0x00000007 )
1298 #define NETLOGON_CONTROL_FIND_USER ( 0x00000008 )
1299 #define NETLOGON_CONTROL_CHANGE_PASSWORD ( 0x00000009 )
1300 #define NETLOGON_CONTROL_TC_VERIFY ( 0x0000000A )
1301 #define NETLOGON_CONTROL_FORCE_DNS_REG ( 0x0000000B )
1302 #define NETLOGON_CONTROL_QUERY_DNS_REG ( 0x0000000C )
1303 #define NETLOGON_CONTROL_BACKUP_CHANGE_LOG ( 0x0000FFFC )
1304 #define NETLOGON_CONTROL_TRUNCATE_LOG ( 0x0000FFFD )
1305 #define NETLOGON_CONTROL_SET_DBFLAG ( 0x0000FFFE )
1306 #define NETLOGON_CONTROL_BREAKPOINT ( 0x0000FFFF )
1307
1308 #endif /* _HEADER_netlogon */
1309
1310 /****************************************************************
1311 ****************************************************************/
1312
1313 struct libnetapi_ctx {
1314         char *debuglevel;
1315         char *error_string;
1316         char *username;
1317         char *workgroup;
1318         char *password;
1319         char *krb5_cc_env;
1320         int use_kerberos;
1321         int use_ccache;
1322         int disable_policy_handle_cache;
1323
1324         void *private_data;
1325 };
1326
1327 /****************************************************************
1328 ****************************************************************/
1329
1330 NET_API_STATUS libnetapi_init(struct libnetapi_ctx **ctx);
1331
1332 /****************************************************************
1333 ****************************************************************/
1334
1335 NET_API_STATUS libnetapi_free(struct libnetapi_ctx *ctx);
1336
1337 /****************************************************************
1338 ****************************************************************/
1339
1340 NET_API_STATUS libnetapi_getctx(struct libnetapi_ctx **ctx);
1341
1342 /****************************************************************
1343 ****************************************************************/
1344
1345 NET_API_STATUS libnetapi_set_debuglevel(struct libnetapi_ctx *ctx,
1346                                         const char *debuglevel);
1347
1348 /****************************************************************
1349 ****************************************************************/
1350
1351 NET_API_STATUS libnetapi_set_username(struct libnetapi_ctx *ctx,
1352                                       const char *username);
1353
1354 /****************************************************************
1355 ****************************************************************/
1356
1357 NET_API_STATUS libnetapi_set_password(struct libnetapi_ctx *ctx,
1358                                       const char *password);
1359
1360 /****************************************************************
1361 ****************************************************************/
1362
1363 NET_API_STATUS libnetapi_set_workgroup(struct libnetapi_ctx *ctx,
1364                                        const char *workgroup);
1365
1366 /****************************************************************
1367 ****************************************************************/
1368
1369 NET_API_STATUS libnetapi_set_use_kerberos(struct libnetapi_ctx *ctx);
1370
1371 /****************************************************************
1372 ****************************************************************/
1373
1374 NET_API_STATUS libnetapi_set_use_ccache(struct libnetapi_ctx *ctx);
1375
1376 /****************************************************************
1377 ****************************************************************/
1378
1379 const char *libnetapi_errstr(NET_API_STATUS status);
1380
1381 /****************************************************************
1382 ****************************************************************/
1383
1384 const char *libnetapi_get_error_string(struct libnetapi_ctx *ctx,
1385                                        NET_API_STATUS status);
1386
1387 /****************************************************************
1388  NetApiBufferAllocate
1389 ****************************************************************/
1390
1391 NET_API_STATUS NetApiBufferAllocate(uint32_t byte_count,
1392                                     void **buffer);
1393
1394 /****************************************************************
1395  NetApiBufferFree
1396 ****************************************************************/
1397
1398 NET_API_STATUS NetApiBufferFree(void *buffer);
1399
1400 /************************************************************//**
1401  *
1402  * ConvertSidToStringSid
1403  *
1404  * @brief Convert a domain sid into a string
1405  *
1406  * @param[in] sid A pointer to a sid structure
1407  * @param[in,out] sid_string A pointer that holds a pointer to a sid string. Caller
1408  * needs to free with free(3)
1409  * @return bool
1410  ***************************************************************/
1411
1412 int  ConvertSidToStringSid(const struct domsid *sid,
1413                            char **sid_string);
1414
1415 /************************************************************//**
1416  *
1417  * ConvertStringSidToSid
1418  *
1419  * @brief Convert a string into a domain sid
1420  *
1421  * @param[in] sid_string A pointer to a sid string.
1422  * @param[in,out] sid A pointer that holds a pointer to a sid structure.
1423  * Caller needs to free with free(3)
1424  * @return bool
1425  ***************************************************************/
1426
1427 int ConvertStringSidToSid(const char *sid_string,
1428                           struct domsid **sid);
1429
1430 /************************************************************//**
1431  *
1432  * NetJoinDomain
1433  *
1434  * @brief Join a computer to a domain or workgroup
1435  *
1436  * @param[in] server The server name to connect to
1437  * @param[in] domain The domain or workgroup to join
1438  * @param[in] account_ou The organizational Unit to create the computer account
1439  * in (AD only)
1440  * @param[in] account The domain account used for joining a domain
1441  * @param[in] password The domain account's password used for joining a domain
1442  * @param[in] join_flags Bitmask field to define specific join features
1443  * @return NET_API_STATUS
1444  *
1445  * example netdomjoin/netdomjoin.c
1446  ***************************************************************/
1447
1448 NET_API_STATUS NetJoinDomain(const char * server /* [in] */,
1449                              const char * domain /* [in] [ref] */,
1450                              const char * account_ou /* [in] */,
1451                              const char * account /* [in] */,
1452                              const char * password /* [in] */,
1453                              uint32_t join_flags /* [in] */);
1454
1455 /************************************************************//**
1456  *
1457  * NetUnjoinDomain
1458  *
1459  * @brief Unjoin a computer from a domain or workgroup
1460  *
1461  * @param[in] server_name The server name to connect to
1462  * @param[in] account The domain account used for unjoining a domain
1463  * @param[in] password The domain account's password used for unjoining a domain
1464  * @param[in] unjoin_flags Bitmask field to define specific unjoin features
1465  * @return NET_API_STATUS
1466  *
1467  ***************************************************************/
1468
1469 NET_API_STATUS NetUnjoinDomain(const char * server_name /* [in] */,
1470                                const char * account /* [in] */,
1471                                const char * password /* [in] */,
1472                                uint32_t unjoin_flags /* [in] */);
1473
1474 /************************************************************//**
1475  *
1476  * NetGetJoinInformation
1477  *
1478  * @brief Unjoin a computer from a domain or workgroup
1479  *
1480  * @param[in] server_name The server name to connect to
1481  * @param[out] name_buffer Returns the name of the workgroup or domain
1482  * @param[out] name_type  Returns the type of that name
1483  * @return NET_API_STATUS
1484  *
1485  * example netdomjoin-gui/netdomjoin-gui.c
1486  *
1487  ***************************************************************/
1488
1489 NET_API_STATUS NetGetJoinInformation(const char * server_name /* [in] */,
1490                                      const char * *name_buffer /* [out] [ref] */,
1491                                      uint16_t *name_type /* [out] [ref] */);
1492
1493 /************************************************************//**
1494  *
1495  * NetGetJoinableOUs
1496  *
1497  * @brief Query for the list of joinable organizational Units that can be used
1498  * for joining AD
1499  *
1500  * @param[in] server_name The server name to connect to
1501  * @param[in] domain The AD domain to query
1502  * @param[in] account The domain account used for the query
1503  * @param[in] password The domain account's password used for the query
1504  * @param[out] ou_count The number of ous returned
1505  * @param[out] ous Returned string array containing the ous
1506  * @return NET_API_STATUS
1507  *
1508  * example netdomjoin-gui/netdomjoin-gui.c
1509  *
1510  ***************************************************************/
1511
1512 NET_API_STATUS NetGetJoinableOUs(const char * server_name /* [in] */,
1513                                  const char * domain /* [in] [ref] */,
1514                                  const char * account /* [in] */,
1515                                  const char * password /* [in] */,
1516                                  uint32_t *ou_count /* [out] [ref] */,
1517                                  const char * **ous /* [out] [ref] */);
1518
1519 /************************************************************//**
1520  *
1521  * NetRenameMachineInDomain
1522  *
1523  * @brief Rename a machine in a domain
1524  *
1525  * @param[in] server_name The server name to connect to
1526  * @param[in] new_machine_name The new machine name
1527  * @param[in] account The domain account used for the query
1528  * @param[in] password The domain account's password used for the query
1529  * @param[in] rename_options Options used for the rename operation
1530  * @return NET_API_STATUS
1531  *
1532  * example join/rename_machine.c
1533  *
1534  ***************************************************************/
1535
1536 NET_API_STATUS NetRenameMachineInDomain(const char * server_name /* [in] */,
1537                                         const char * new_machine_name /* [in] */,
1538                                         const char * account /* [in] */,
1539                                         const char * password /* [in] */,
1540                                         uint32_t rename_options /* [in] */);
1541
1542 /************************************************************//**
1543  *
1544  * NetServerGetInfo
1545  *
1546  * @brief Get Information on a server
1547  *
1548  * @param[in] server_name The server name to connect to
1549  * @param[in] level The level to define which information is requested
1550  * @param[out] buffer The returned buffer carrying the SERVER_INFO structure
1551  * @return NET_API_STATUS
1552  *
1553  ***************************************************************/
1554
1555 NET_API_STATUS NetServerGetInfo(const char * server_name /* [in] */,
1556                                 uint32_t level /* [in] */,
1557                                 uint8_t **buffer /* [out] [ref] */);
1558
1559 /************************************************************//**
1560  *
1561  * NetServerSetInfo
1562  *
1563  * @brief Get Information on a server
1564  *
1565  * @param[in] server_name The server name to connect to
1566  * @param[in] level The level to define which information is set
1567  * @param[in] buffer The buffer carrying the SERVER_INFO structure
1568  * @param[out] parm_error On failure returns the invalid SERVER_INFO member
1569  * @return NET_API_STATUS
1570  *
1571  ***************************************************************/
1572
1573 NET_API_STATUS NetServerSetInfo(const char * server_name /* [in] */,
1574                                 uint32_t level /* [in] */,
1575                                 uint8_t *buffer /* [in] [ref] */,
1576                                 uint32_t *parm_error /* [out] [ref] */);
1577
1578 /************************************************************//**
1579  *
1580  * NetGetDCName
1581  *
1582  * @brief Query for the PDC for a given domain
1583  *
1584  * @param[in] server_name The server name to connect to
1585  * @param[in] domain_name The name of the domain to lookup
1586  * @param[out] buffer The name of the domain to lookup
1587  * @return NET_API_STATUS
1588  *
1589  * example getdc/getdc.c
1590  ***************************************************************/
1591
1592 NET_API_STATUS NetGetDCName(const char * server_name /* [in] */,
1593                             const char * domain_name /* [in] */,
1594                             uint8_t **buffer /* [out] [ref] */);
1595
1596 /************************************************************//**
1597  *
1598  * NetGetAnyDCName
1599  *
1600  * @brief Query for any DC for a given domain
1601  *
1602  * @param[in] server_name The server name to connect to
1603  * @param[in] domain_name The name of the domain to lookup
1604  * @param[out] buffer The name of the domain to lookup
1605  * @return NET_API_STATUS
1606  *
1607  * example getdc/getdc.c
1608  ***************************************************************/
1609
1610 NET_API_STATUS NetGetAnyDCName(const char * server_name /* [in] */,
1611                                const char * domain_name /* [in] */,
1612                                uint8_t **buffer /* [out] [ref] */);
1613
1614
1615 /************************************************************//**
1616  *
1617  * DsGetDcName
1618  *
1619  * @brief Lookup a DC for a given domain and return information structure
1620  *
1621  * @param[in] server_name The server name to connect to
1622  * @param[in] domain_name The name of the domain to lookup (cannot be NULL)
1623  * @param[in] domain_guid The GUID of the domain to lookup (optional)
1624  * @param[in] site_name The name of the site the DC should reside in
1625  * @param[in] flags A bitmask to request specific features supported by the DC
1626  * @param[out] dc_info Pointer to a DOMAIN_CONTROLLER_INFO structure
1627  * @return NET_API_STATUS
1628  *
1629  * example dsgetdc/dsgetdc.c
1630  ***************************************************************/
1631
1632 NET_API_STATUS DsGetDcName(const char * server_name /* [in] [unique] */,
1633                            const char * domain_name /* [in] [ref] */,
1634                            struct GUID *domain_guid /* [in] [unique] */,
1635                            const char * site_name /* [in] [unique] */,
1636                            uint32_t flags /* [in] */,
1637                            struct DOMAIN_CONTROLLER_INFO **dc_info /* [out] [ref] */);
1638
1639 /************************************************************//**
1640  *
1641  * NetUserAdd
1642  *
1643  * @brief Create a user on a given server
1644  *
1645  * @param[in] server_name The server name to connect to
1646  * @param[in] level The level of the USER_INFO structure passed in (Currently
1647  * only level 1 is supported)
1648  * @param[in] buffer The buffer carrying the USER_INFO structure
1649  * @param[out] parm_error In case of error returns the failing member of the
1650  * structure
1651  * @return NET_API_STATUS
1652  *
1653  * example user/user_add.c
1654  ***************************************************************/
1655
1656 NET_API_STATUS NetUserAdd(const char * server_name /* [in] */,
1657                           uint32_t level /* [in] */,
1658                           uint8_t *buffer /* [in] [ref] */,
1659                           uint32_t *parm_error /* [out] [ref] */);
1660
1661 /************************************************************//**
1662  *
1663  * NetUserDel
1664  *
1665  * @brief Delete a user on a given server
1666  *
1667  * @param[in] server_name The server name to connect to
1668  * @param[in] user_name The user account to delete
1669  * @return NET_API_STATUS
1670  *
1671  * example user/user_del.c
1672  ***************************************************************/
1673
1674 NET_API_STATUS NetUserDel(const char * server_name /* [in] */,
1675                           const char * user_name /* [in] */);
1676
1677 /************************************************************//**
1678  *
1679  * NetUserEnum
1680  *
1681  * @brief Enumerate accounts on a server
1682  *
1683  * @param[in] server_name The server name to connect to
1684  * @param[in] level The enumeration level used for the query (Currently only
1685  * level 0 is supported)
1686  * @param[in] filter The account flags filter used for the query
1687  * @param[out] buffer The returned enumeration buffer
1688  * @param[in] prefmaxlen The requested maximal buffer size
1689  * @param[out] entries_read The number of returned entries
1690  * @param[out] total_entries The number of total entries
1691  * @param[in,out] resume_handle A handle passed in and returned for resuming
1692  * operations
1693  * @return NET_API_STATUS
1694  *
1695  * example user/user_enum.c
1696  ***************************************************************/
1697
1698 NET_API_STATUS NetUserEnum(const char * server_name /* [in] */,
1699                            uint32_t level /* [in] */,
1700                            uint32_t filter /* [in] */,
1701                            uint8_t **buffer /* [out] [ref] */,
1702                            uint32_t prefmaxlen /* [in] */,
1703                            uint32_t *entries_read /* [out] [ref] */,
1704                            uint32_t *total_entries /* [out] [ref] */,
1705                            uint32_t *resume_handle /* [in,out] [ref] */);
1706
1707 /************************************************************//**
1708  *
1709  * NetUserChangePassword
1710  *
1711  * @brief Change the password for a user on a given server or in a given domain
1712  *
1713  * @param[in] domain_name The server or domain name to connect to
1714  * @param[in] user_name The user account to change the password for
1715  * @param[in] old_password The user account's old password
1716  * @param[in] new_password The user account's new password
1717  * @return NET_API_STATUS
1718  *
1719  * example user/user_chgpwd.c
1720  ***************************************************************/
1721
1722 NET_API_STATUS NetUserChangePassword(const char * domain_name /* [in] */,
1723                                      const char * user_name /* [in] */,
1724                                      const char * old_password /* [in] */,
1725                                      const char * new_password /* [in] */);
1726
1727 /************************************************************//**
1728  *
1729  * NetUserGetInfo
1730  *
1731  * @brief Get User Information
1732  *
1733  * @param[in] server_name The server name to connect to
1734  * @param[in] user_name The name of the user that is going to be queried
1735  * @param[in] level The level defining the requested USER_INFO_X structure
1736  * @param[out] buffer The buffer containing a USER_INFO_X structure
1737  * @return NET_API_STATUS
1738  *
1739  * example user/user_getinfo.c
1740  ***************************************************************/
1741
1742 NET_API_STATUS NetUserGetInfo(const char * server_name /* [in] */,
1743                               const char * user_name /* [in] */,
1744                               uint32_t level /* [in] */,
1745                               uint8_t **buffer /* [out] [ref] */);
1746
1747 /************************************************************//**
1748  *
1749  * NetUserSetInfo
1750  *
1751  * @brief Set User Information
1752  *
1753  * @param[in] server_name The server name to connect to
1754  * @param[in] user_name The name of the user that is going to be modified
1755  * @param[in] level The level defining the requested USER_INFO_X structure
1756  * @param[in] buffer The buffer containing a USER_INFO_X structure
1757  * @param[out] parm_err The returned parameter error number if any
1758  * @return NET_API_STATUS
1759  *
1760  * example user/user_setinfo.c
1761  ***************************************************************/
1762
1763 NET_API_STATUS NetUserSetInfo(const char * server_name /* [in] */,
1764                               const char * user_name /* [in] */,
1765                               uint32_t level /* [in] */,
1766                               uint8_t *buffer /* [in] [ref] */,
1767                               uint32_t *parm_err /* [out] [ref] */);
1768
1769 /************************************************************//**
1770  *
1771  * NetUserModalsGet
1772  *
1773  * @brief Get SAM domain and password information
1774  *
1775  * @param[in] server_name The server name to connect to
1776  * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1777  * @param[out] buffer The returned USER_MODALS_INFO_X buffer
1778  * @return NET_API_STATUS
1779  *
1780  * example user/user_modalsget.c
1781  ***************************************************************/
1782
1783 NET_API_STATUS NetUserModalsGet(const char * server_name /* [in] */,
1784                                 uint32_t level /* [in] */,
1785                                 uint8_t **buffer /* [out] [ref] */);
1786
1787 /************************************************************//**
1788  *
1789  * NetUserModalsSet
1790  *
1791  * @brief Set SAM domain and password information
1792  *
1793  * @param[in] server_name The server name to connect to
1794  * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1795  * @param[out] buffer The buffer conntaing a USER_MODALS_INFO_X structure
1796  * @param[out] parm_err The returned parameter error number if any
1797  * @return NET_API_STATUS
1798  *
1799  * example user/user_modalsset.c
1800  ***************************************************************/
1801
1802 NET_API_STATUS NetUserModalsSet(const char * server_name /* [in] */,
1803                                 uint32_t level /* [in] */,
1804                                 uint8_t *buffer /* [in] [ref] */,
1805                                 uint32_t *parm_err /* [out] [ref] */);
1806
1807 /************************************************************//**
1808  *
1809  * NetUserGetGroups
1810  *
1811  * @brief Enumerate grouplist of a user on a server
1812  *
1813  * @param[in] server_name The server name to connect to
1814  * @param[in] user_name The user name to query
1815  * @param[in] level The enumeration level used for the query (Currently only
1816  * level 0 is supported)
1817  * @param[out] buffer The returned enumeration buffer
1818  * @param[in] prefmaxlen The requested maximal buffer size
1819  * @param[out] entries_read The number of returned entries
1820  * @param[out] total_entries The number of total entries
1821  * @return NET_API_STATUS
1822  *
1823  * example user/user_getgroups.c
1824  ***************************************************************/
1825
1826 NET_API_STATUS NetUserGetGroups(const char * server_name /* [in] */,
1827                                 const char * user_name /* [in] */,
1828                                 uint32_t level /* [in] */,
1829                                 uint8_t **buffer /* [out] [ref] */,
1830                                 uint32_t prefmaxlen /* [in] */,
1831                                 uint32_t *entries_read /* [out] [ref] */,
1832                                 uint32_t *total_entries /* [out] [ref] */);
1833
1834 /************************************************************//**
1835  *
1836  * NetUserSetGroups
1837  *
1838  * @brief Set grouplist of a user on a server
1839  *
1840  * @param[in] server_name The server name to connect to
1841  * @param[in] user_name The user name to query
1842  * @param[in] level The level defining the GROUP_USERS_INFO_X structures in the buffer
1843  * @param[in] buffer The buffer containing GROUP_USERS_INFO_X structures
1844  * @param[in] num_entries The number of X structures in the buffer
1845  * @return NET_API_STATUS
1846  *
1847  * example user/user_setgroups.c
1848  ***************************************************************/
1849
1850 NET_API_STATUS NetUserSetGroups(const char * server_name /* [in] */,
1851                                 const char * user_name /* [in] */,
1852                                 uint32_t level /* [in] */,
1853                                 uint8_t *buffer /* [in] [ref] */,
1854                                 uint32_t num_entries /* [in] */);
1855
1856 /************************************************************//**
1857  *
1858  * NetUserGetLocalGroups
1859  *
1860  * @brief Enumerate local grouplist of a user on a server
1861  *
1862  * @param[in] server_name The server name to connect to
1863  * @param[in] user_name The user name to query
1864  * @param[in] level The enumeration level used for the query
1865  * @param[in] flags The flags used for the query
1866  * @param[out] buffer The returned enumeration buffer
1867  * @param[in] prefmaxlen The requested maximal buffer size
1868  * @param[out] entries_read The number of returned entries
1869  * @param[out] total_entries The number of total entries
1870  * @return NET_API_STATUS
1871  *
1872  * example user/user_getlocalgroups.c
1873  ***************************************************************/
1874
1875 NET_API_STATUS NetUserGetLocalGroups(const char * server_name /* [in] */,
1876                                      const char * user_name /* [in] */,
1877                                      uint32_t level /* [in] */,
1878                                      uint32_t flags /* [in] */,
1879                                      uint8_t **buffer /* [out] [ref] */,
1880                                      uint32_t prefmaxlen /* [in] */,
1881                                      uint32_t *entries_read /* [out] [ref] */,
1882                                      uint32_t *total_entries /* [out] [ref] */);
1883
1884 /************************************************************//**
1885  *
1886  * NetQueryDisplayInformation
1887  *
1888  * @brief Enumerate accounts on a server
1889  *
1890  * @param[in] server_name The server name to connect to
1891  * @param[in] level The enumeration level used for the query
1892  * @param[in] idx The index to start the the display enumeration at
1893  * @param[in] entries_requested The number of entries requested
1894  * @param[in] prefmaxlen The requested maximal buffer size
1895  * @param[out] entries_read The number of returned entries
1896  * @param[out] buffer The returned display information buffer
1897  * @return NET_API_STATUS
1898  *
1899  * example user/user_dispinfo.c
1900  ***************************************************************/
1901
1902 NET_API_STATUS NetQueryDisplayInformation(const char * server_name /* [in] [unique] */,
1903                                           uint32_t level /* [in] */,
1904                                           uint32_t idx /* [in] */,
1905                                           uint32_t entries_requested /* [in] */,
1906                                           uint32_t prefmaxlen /* [in] */,
1907                                           uint32_t *entries_read /* [out] [ref] */,
1908                                           void **buffer /* [out] [noprint,ref] */);
1909
1910 /************************************************************//**
1911  *
1912  * NetGroupAdd
1913  *
1914  * @brief Create Domain Group
1915  *
1916  * @param[in] server_name The server name to connect to
1917  * @param[in] level The level used for the new group creation
1918  * @param[in] buf The buffer containing the group structure
1919  * @param[out] parm_err The returned parameter error number if any
1920  * @return NET_API_STATUS
1921  *
1922  * example group/group_add.c
1923  ***************************************************************/
1924
1925 NET_API_STATUS NetGroupAdd(const char * server_name /* [in] */,
1926                            uint32_t level /* [in] */,
1927                            uint8_t *buf /* [in] [ref] */,
1928                            uint32_t *parm_err /* [out] [ref] */);
1929
1930 /************************************************************//**
1931  *
1932  * NetGroupDel
1933  *
1934  * @brief Delete Domain Group
1935  *
1936  * @param[in] server_name The server name to connect to
1937  * @param[in] group_name The name of the group that is going to be deleted
1938  * @return NET_API_STATUS
1939  *
1940  * example group/group_del.c
1941  ***************************************************************/
1942
1943 NET_API_STATUS NetGroupDel(const char * server_name /* [in] */,
1944                            const char * group_name /* [in] */);
1945
1946 /************************************************************//**
1947  *
1948  * NetGroupEnum
1949  *
1950  * @brief Enumerate groups on a server
1951  *
1952  * @param[in] server_name The server name to connect to
1953  * @param[in] level The enumeration level used for the query (Currently only
1954  * level 0 is supported)
1955  * @param[out] buffer The returned enumeration buffer
1956  * @param[in] prefmaxlen The requested maximal buffer size
1957  * @param[out] entries_read The number of returned entries
1958  * @param[out] total_entries The number of total entries
1959  * @param[in,out] resume_handle A handle passed in and returned for resuming
1960  * operations
1961  * @return NET_API_STATUS
1962  *
1963  * example group/group_enum.c
1964  ***************************************************************/
1965
1966 NET_API_STATUS NetGroupEnum(const char * server_name /* [in] */,
1967                             uint32_t level /* [in] */,
1968                             uint8_t **buffer /* [out] [ref] */,
1969                             uint32_t prefmaxlen /* [in] */,
1970                             uint32_t *entries_read /* [out] [ref] */,
1971                             uint32_t *total_entries /* [out] [ref] */,
1972                             uint32_t *resume_handle /* [in,out] [ref] */);
1973
1974 /************************************************************//**
1975  *
1976  * NetGroupSetInfo
1977  *
1978  * @brief Set Domain Group Information
1979  *
1980  * @param[in] server_name The server name to connect to
1981  * @param[in] group_name The name of the group that is going to be modified
1982  * @param[in] level The level defining the structure type in buf
1983  * @param[in] buf The buffer containing a GROUP_INFO_X structure
1984  * @param[out] parm_err The returned parameter error number if any
1985  * @return NET_API_STATUS
1986  *
1987  * example group/group_setinfo.c
1988  ***************************************************************/
1989
1990 NET_API_STATUS NetGroupSetInfo(const char * server_name /* [in] */,
1991                                const char * group_name /* [in] */,
1992                                uint32_t level /* [in] */,
1993                                uint8_t *buf /* [in] [ref] */,
1994                                uint32_t *parm_err /* [out] [ref] */);
1995
1996 /************************************************************//**
1997  *
1998  * NetGroupGetInfo
1999  *
2000  * @brief Get Domain Group Information
2001  *
2002  * @param[in] server_name The server name to connect to
2003  * @param[in] group_name The name of the group that is going to be queried
2004  * @param[in] level The level defining the requested GROUP_INFO_X structure
2005  * @param[out] buf The buffer containing a GROUP_INFO_X structure
2006  * @return NET_API_STATUS
2007  *
2008  * example group/group_getinfo.c
2009  ***************************************************************/
2010
2011 NET_API_STATUS NetGroupGetInfo(const char * server_name /* [in] */,
2012                                const char * group_name /* [in] */,
2013                                uint32_t level /* [in] */,
2014                                uint8_t **buf /* [out] [ref] */);
2015
2016 /************************************************************//**
2017  *
2018  * NetGroupAddUser
2019  *
2020  * @brief Add existing User to existing Domain Group
2021  *
2022  * @param[in] server_name The server name to connect to
2023  * @param[in] group_name The name of the group that is going to be modified
2024  * @param[in] user_name The name of the user that is going to be added to the
2025  * group
2026  * @return NET_API_STATUS
2027  *
2028  * example group/group_adduser.c
2029  ***************************************************************/
2030
2031 NET_API_STATUS NetGroupAddUser(const char * server_name /* [in] */,
2032                                const char * group_name /* [in] */,
2033                                const char * user_name /* [in] */);
2034
2035 /************************************************************//**
2036  *
2037  * NetGroupDelUser
2038  *
2039  * @brief Remove User from Domain Group
2040  *
2041  * @param[in] server_name The server name to connect to
2042  * @param[in] group_name The name of the group that is going to be modified
2043  * @param[in] user_name The name of the user that is going to be removed from
2044  * the group
2045  * @return NET_API_STATUS
2046  *
2047  * example group/group_deluser.c
2048  ***************************************************************/
2049
2050 NET_API_STATUS NetGroupDelUser(const char * server_name /* [in] */,
2051                                const char * group_name /* [in] */,
2052                                const char * user_name /* [in] */);
2053
2054 /************************************************************//**
2055  *
2056  * NetGroupGetUsers
2057  *
2058  * @brief Get Users for a group on a server
2059  *
2060  * @param[in] server_name The server name to connect to
2061  * @param[in] group_name The group name to enumerate users for
2062  * @param[in] level The enumeration level used for the query
2063  * @param[out] buffer The returned enumeration buffer
2064  * @param[in] prefmaxlen The requested maximal buffer size
2065  * @param[out] entries_read The number of returned entries
2066  * @param[out] total_entries The number of total entries
2067  * @param[in,out] resume_handle A handle passed in and returned for resuming
2068  * operations
2069  * @return NET_API_STATUS
2070  *
2071  * example group/group_getusers.c
2072  ***************************************************************/
2073
2074 NET_API_STATUS NetGroupGetUsers(const char * server_name /* [in] */,
2075                                 const char * group_name /* [in] */,
2076                                 uint32_t level /* [in] */,
2077                                 uint8_t **buffer /* [out] [ref] */,
2078                                 uint32_t prefmaxlen /* [in] */,
2079                                 uint32_t *entries_read /* [out] [ref] */,
2080                                 uint32_t *total_entries /* [out] [ref] */,
2081                                 uint32_t *resume_handle /* [in,out] [ref] */);
2082
2083 /************************************************************//**
2084  *
2085  * NetGroupSetUsers
2086  *
2087  * @brief Set Users for a group on a server
2088  *
2089  * @param[in] server_name The server name to connect to
2090  * @param[in] group_name The group name to enumerate users for
2091  * @param[in] level The enumeration level used for the query
2092  * @param[in] buffer The buffer containing a X structure
2093  * @param[in] num_entries The number of X entries in the buffer
2094  * @return NET_API_STATUS
2095  *
2096  * example group/group_setusers.c
2097  ***************************************************************/
2098
2099 NET_API_STATUS NetGroupSetUsers(const char * server_name /* [in] */,
2100                                 const char * group_name /* [in] */,
2101                                 uint32_t level /* [in] */,
2102                                 uint8_t *buffer /* [in] [ref] */,
2103                                 uint32_t num_entries /* [in] */);
2104
2105 /************************************************************//**
2106  *
2107  * NetLocalGroupAdd
2108  *
2109  * @brief Create Local Group
2110  *
2111  * @param[in] server_name The server name to connect to
2112  * @param[in] level The level used for the new group creation
2113  * @param[in] buf The buffer containing the group structure
2114  * @param[out] parm_err The returned parameter error number if any
2115  * @return NET_API_STATUS
2116  *
2117  * example localgroup/localgroup_add.c
2118  ***************************************************************/
2119
2120 NET_API_STATUS NetLocalGroupAdd(const char * server_name /* [in] */,
2121                                 uint32_t level /* [in] */,
2122                                 uint8_t *buf /* [in] [ref] */,
2123                                 uint32_t *parm_err /* [out] [ref] */);
2124
2125 /************************************************************//**
2126  *
2127  * NetLocalGroupDel
2128  *
2129  * @brief Delete Local Group
2130  *
2131  * @param[in] server_name The server name to connect to
2132  * @param[in] group_name The name of the group that is going to be deleted
2133  * @return NET_API_STATUS
2134  *
2135  * example localgroup/localgroup_del.c
2136  ***************************************************************/
2137
2138
2139 NET_API_STATUS NetLocalGroupDel(const char * server_name /* [in] */,
2140                                 const char * group_name /* [in] */);
2141
2142 /************************************************************//**
2143  *
2144  * NetLocalGroupGetInfo
2145  *
2146  * @brief Get Local Group Information
2147  *
2148  * @param[in] server_name The server name to connect to
2149  * @param[in] group_name The name of the group that is going to be queried
2150  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2151  * @param[out] buf The buffer containing a LOCALGROUP_INFO_X structure
2152  * @return NET_API_STATUS
2153  *
2154  * example localgroup/localgroup_getinfo.c
2155  ***************************************************************/
2156
2157 NET_API_STATUS NetLocalGroupGetInfo(const char * server_name /* [in] */,
2158                                     const char * group_name /* [in] */,
2159                                     uint32_t level /* [in] */,
2160                                     uint8_t **buf /* [out] [ref] */);
2161
2162 /************************************************************//**
2163  *
2164  * NetLocalGroupSetInfo
2165  *
2166  * @brief Set Local Group Information
2167  *
2168  * @param[in] server_name The server name to connect to
2169  * @param[in] group_name The name of the group that is going to be modified
2170  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2171  * @param[in] buf The buffer containing a LOCALGROUP_INFO_X structure
2172  * @param[out] parm_err The returned parameter error number if any
2173  * @return NET_API_STATUS
2174  *
2175  * example localgroup/localgroup_setinfo.c
2176  ***************************************************************/
2177
2178
2179 NET_API_STATUS NetLocalGroupSetInfo(const char * server_name /* [in] */,
2180                                     const char * group_name /* [in] */,
2181                                     uint32_t level /* [in] */,
2182                                     uint8_t *buf /* [in] [ref] */,
2183                                     uint32_t *parm_err /* [out] [ref] */);
2184
2185 /************************************************************//**
2186  *
2187  * NetLocalGroupEnum
2188  *
2189  * @brief Enumerate local groups on a server
2190  *
2191  * @param[in] server_name The server name to connect to
2192  * @param[in] level The enumeration level used for the query (Currently only
2193  * level 0 is supported)
2194  * @param[out] buffer The returned enumeration buffer
2195  * @param[in] prefmaxlen The requested maximal buffer size
2196  * @param[out] entries_read The number of returned entries
2197  * @param[out] total_entries The number of total entries
2198  * @param[in,out] resume_handle A handle passed in and returned for resuming
2199  * operations
2200  * @return NET_API_STATUS
2201  *
2202  * example localgroup/localgroup_enum.c
2203  ***************************************************************/
2204
2205 NET_API_STATUS NetLocalGroupEnum(const char * server_name /* [in] */,
2206                                  uint32_t level /* [in] */,
2207                                  uint8_t **buffer /* [out] [ref] */,
2208                                  uint32_t prefmaxlen /* [in] */,
2209                                  uint32_t *entries_read /* [out] [ref] */,
2210                                  uint32_t *total_entries /* [out] [ref] */,
2211                                  uint32_t *resume_handle /* [in,out] [ref] */);
2212
2213 /************************************************************//**
2214  *
2215  * NetLocalGroupAddMembers
2216  *
2217  * @brief Add Members to a Local Group
2218  *
2219  * @param[in] server_name The server name to connect to
2220  * @param[in] group_name The name of the group that is going to modified
2221  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2222  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2223  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2224  * the buffer
2225  * @return NET_API_STATUS
2226  *
2227  * example localgroup/localgroup_addmembers.c
2228  ***************************************************************/
2229
2230 NET_API_STATUS NetLocalGroupAddMembers(const char * server_name /* [in] */,
2231                                        const char * group_name /* [in] */,
2232                                        uint32_t level /* [in] */,
2233                                        uint8_t *buffer /* [in] [ref] */,
2234                                        uint32_t total_entries /* [in] */);
2235
2236 /************************************************************//**
2237  *
2238  * NetLocalGroupDelMembers
2239  *
2240  * @brief Delete Members from a Local Group
2241  *
2242  * @param[in] server_name The server name to connect to
2243  * @param[in] group_name The name of the group that is going to modified
2244  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2245  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2246  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2247  * the buffer
2248  * @return NET_API_STATUS
2249  *
2250  * example localgroup/localgroup_delmembers.c
2251  ***************************************************************/
2252
2253 NET_API_STATUS NetLocalGroupDelMembers(const char * server_name /* [in] */,
2254                                        const char * group_name /* [in] */,
2255                                        uint32_t level /* [in] */,
2256                                        uint8_t *buffer /* [in] [ref] */,
2257                                        uint32_t total_entries /* [in] */);
2258
2259 /************************************************************//**
2260  *
2261  * NetLocalGroupGetMembers
2262  *
2263  * @brief Enumerate Members in a local group
2264  *
2265  * @param[in] server_name The server name to connect to
2266  * @param[in] local_group_name The localgroup that is going to be queried
2267  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2268  * @param[out] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X
2269  * structure
2270  * @param[in] prefmaxlen The requested maximal buffer size
2271  * @param[out] entries_read The number of LOCALGROUP_MEMBERS_INFO_X entries in the buffer
2272  * @param[out] total_entries The total number of LOCALGROUP_MEMBERS_INFO_X entries for that group
2273  * @param[in,out] resume_handle A handle passed in and returned for resuming
2274  * operations
2275  * @return NET_API_STATUS
2276  *
2277  * example localgroup/localgroup_getmembers.c
2278  ***************************************************************/
2279
2280 NET_API_STATUS NetLocalGroupGetMembers(const char * server_name /* [in] */,
2281                                        const char * local_group_name /* [in] */,
2282                                        uint32_t level /* [in] */,
2283                                        uint8_t **buffer /* [out] [ref] */,
2284                                        uint32_t prefmaxlen /* [in] */,
2285                                        uint32_t *entries_read /* [out] [ref] */,
2286                                        uint32_t *total_entries /* [out] [ref] */,
2287                                        uint32_t *resume_handle /* [in,out] [ref] */);
2288
2289 /************************************************************//**
2290  *
2291  * NetLocalGroupSetMembers
2292  *
2293  * @brief Set Members in a Local Group
2294  *
2295  * @param[in] server_name The server name to connect to
2296  * @param[in] group_name The name of the group that is going to modified
2297  * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2298  * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2299  * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2300  * the buffer
2301  * @return NET_API_STATUS
2302  *
2303  * example localgroup/localgroup_setmembers.c
2304  ***************************************************************/
2305
2306 NET_API_STATUS NetLocalGroupSetMembers(const char * server_name /* [in] */,
2307                                        const char * group_name /* [in] */,
2308                                        uint32_t level /* [in] */,
2309                                        uint8_t *buffer /* [in] [ref] */,
2310                                        uint32_t total_entries /* [in] */);
2311
2312 /************************************************************//**
2313  *
2314  * NetRemoteTOD
2315  *
2316  * @brief Query remote Time of Day
2317  *
2318  * @param[in] server_name The server name to connect to
2319  * @param[out] buf The buffer containing a TIME_OF_DAY_INFO structure
2320  * @return NET_API_STATUS
2321  *
2322  * example server/remote_tod.c
2323  ***************************************************************/
2324
2325 NET_API_STATUS NetRemoteTOD(const char * server_name /* [in] */,
2326                             uint8_t **buf /* [out] [ref] */);
2327
2328 /************************************************************//**
2329  *
2330  * NetShareAdd
2331  *
2332  * @brief Add Share
2333  *
2334  * @param[in] server_name The server name to connect to
2335  * @param[in] level The level defining the requested SHARE_INFO_X structure
2336  * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2337  * @param[out] parm_err The returned parameter error number if any
2338  * @return NET_API_STATUS
2339  *
2340  * example share/share_add.c
2341  ***************************************************************/
2342
2343 NET_API_STATUS NetShareAdd(const char * server_name /* [in] */,
2344                            uint32_t level /* [in] */,
2345                            uint8_t *buffer /* [in] [ref] */,
2346                            uint32_t *parm_err /* [out] [ref] */);
2347
2348 /************************************************************//**
2349  *
2350  * NetShareDel
2351  *
2352  * @brief Delete Share
2353  *
2354  * @param[in] server_name The server name to connect to
2355  * @param[in] net_name The name of the share to delete
2356  * @param[in] reserved
2357  * @return NET_API_STATUS
2358  *
2359  * example share/share_del.c
2360  ***************************************************************/
2361
2362 NET_API_STATUS NetShareDel(const char * server_name /* [in] */,
2363                            const char * net_name /* [in] */,
2364                            uint32_t reserved /* [in] */);
2365
2366 /************************************************************//**
2367  *
2368  * NetShareEnum
2369  *
2370  * @brief Enumerate Shares
2371  *
2372  * @param[in] server_name The server name to connect to
2373  * @param[in] level The level defining the SHARE_INFO_X structure
2374  * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2375  * @param[in] prefmaxlen The requested maximal buffer size
2376  * @param[out] entries_read The number of SHARE_INFO_X entries in the buffer
2377  * @param[out] total_entries The total number of SHARE_INFO_X entries
2378  * @param[in,out] resume_handle A handle passed in and returned for resuming
2379  * operations
2380  * @return NET_API_STATUS
2381  *
2382  * example share/share_enum.c
2383  ***************************************************************/
2384
2385 NET_API_STATUS NetShareEnum(const char * server_name /* [in] */,
2386                             uint32_t level /* [in] */,
2387                             uint8_t **buffer /* [out] [ref] */,
2388                             uint32_t prefmaxlen /* [in] */,
2389                             uint32_t *entries_read /* [out] [ref] */,
2390                             uint32_t *total_entries /* [out] [ref] */,
2391                             uint32_t *resume_handle /* [in,out] [ref] */);
2392
2393 /************************************************************//**
2394  *
2395  * NetShareGetInfo
2396  *
2397  * @brief Get Share Info
2398  *
2399  * @param[in] server_name The server name to connect to
2400  * @param[in] net_name The name of the share to query
2401  * @param[in] level The level defining the SHARE_INFO_X structure
2402  * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2403  * @return NET_API_STATUS
2404  *
2405  * example share/share_getinfo.c
2406  ***************************************************************/
2407
2408 NET_API_STATUS NetShareGetInfo(const char * server_name /* [in] */,
2409                                const char * net_name /* [in] */,
2410                                uint32_t level /* [in] */,
2411                                uint8_t **buffer /* [out] [ref] */);
2412
2413 /************************************************************//**
2414  *
2415  * NetShareSetInfo
2416  *
2417  * @brief Set Share Info
2418  *
2419  * @param[in] server_name The server name to connect to
2420  * @param[in] net_name The name of the share to query
2421  * @param[in] level The level defining the SHARE_INFO_X structure
2422  * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2423  * @param[out] parm_err The returned parameter error number if any
2424  * @return NET_API_STATUS
2425  *
2426  * example share/share_setinfo.c
2427  ***************************************************************/
2428
2429 NET_API_STATUS NetShareSetInfo(const char * server_name /* [in] */,
2430                                const char * net_name /* [in] */,
2431                                uint32_t level /* [in] */,
2432                                uint8_t *buffer /* [in] [ref] */,
2433                                uint32_t *parm_err /* [out] [ref] */);
2434
2435 /************************************************************//**
2436  *
2437  * NetFileClose
2438  *
2439  * @brief Close a file
2440  *
2441  * @param[in] server_name The server name to connect to
2442  * @param[in] fileid The fileid of the file that is going to be closed
2443  * @return NET_API_STATUS
2444  *
2445  * example file/file_close.c
2446  ***************************************************************/
2447
2448 NET_API_STATUS NetFileClose(const char * server_name /* [in] */,
2449                             uint32_t fileid /* [in] */);
2450
2451 /************************************************************//**
2452  *
2453  * NetFileGetInfo
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  * @param[in] level The level of the FILE_INFO_X buffer
2460  * @param[out] buffer The buffer containing a FILE_INFO_X structure
2461  * @return NET_API_STATUS
2462  *
2463  * example file/file_getinfo.c
2464  ***************************************************************/
2465
2466 NET_API_STATUS NetFileGetInfo(const char * server_name /* [in] */,
2467                               uint32_t fileid /* [in] */,
2468                               uint32_t level /* [in] */,
2469                               uint8_t **buffer /* [out] [ref] */);
2470
2471 /************************************************************//**
2472  *
2473  * NetFileEnum
2474  *
2475  * @brief Enumerate Files
2476  *
2477  * @param[in] server_name The server name to connect to
2478  * @param[in] base_path The
2479  * @param[in] user_name The
2480  * @param[in] level The level defining the FILE_INFO_X structure
2481  * @param[out] buffer The buffer containing a FILE_INFO_X structure
2482  * @param[in] prefmaxlen The requested maximal buffer size
2483  * @param[out] entries_read The number of FILE_INFO_X entries in the buffer
2484  * @param[out] total_entries The total number of FILE_INFO_X entries
2485  * @param[in,out] resume_handle A handle passed in and returned for resuming
2486  * operations
2487  * @return NET_API_STATUS
2488  *
2489  * example file/file_enum.c
2490  ***************************************************************/
2491
2492 NET_API_STATUS NetFileEnum(const char * server_name /* [in] */,
2493                            const char * base_path /* [in] */,
2494                            const char * user_name /* [in] */,
2495                            uint32_t level /* [in] */,
2496                            uint8_t **buffer /* [out] [ref] */,
2497                            uint32_t prefmaxlen /* [in] */,
2498                            uint32_t *entries_read /* [out] [ref] */,
2499                            uint32_t *total_entries /* [out] [ref] */,
2500                            uint32_t *resume_handle /* [in,out] [ref] */);
2501
2502 /************************************************************//**
2503  *
2504  * NetShutdownInit
2505  *
2506  * @brief Start a machine shutdown
2507  *
2508  * @param[in] server_name The server name to connect to
2509  * @param[in] message The message that is displayed before the shutdown
2510  * @param[in] timeout The amount of seconds to wait until shutting down
2511  * @param[in] force_apps Whether to close all applications before the shutdown
2512  * @param[in] do_reboot Whether to reboot after the shutdown
2513  * @return NET_API_STATUS
2514  *
2515  * example shutdown/shutdown_init.c
2516  ***************************************************************/
2517
2518 NET_API_STATUS NetShutdownInit(const char * server_name /* [in] */,
2519                                const char * message /* [in] */,
2520                                uint32_t timeout /* [in] */,
2521                                uint8_t force_apps /* [in] */,
2522                                uint8_t do_reboot /* [in] */);
2523
2524 /************************************************************//**
2525  *
2526  * NetShutdownAbort
2527  *
2528  * @brief Abort an initiated machine shutdown
2529  *
2530  * @param[in] server_name The server name to connect to
2531  * @return NET_API_STATUS
2532  *
2533  * example shutdown/shutdown_abort.c
2534  ***************************************************************/
2535
2536 NET_API_STATUS NetShutdownAbort(const char * server_name /* [in] */);
2537
2538 /************************************************************//**
2539  *
2540  * I_NetLogonControl
2541  *
2542  * @brief Control various aspects of the NETLOGON service
2543  *
2544  * @param[in] server_name The server name to connect to
2545  * @param[in] function_code The function code to call on the server
2546  * @param[in] query_level The level of the NETLOGON_INFO structure returned
2547  * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2548  * @return NET_API_STATUS
2549  *
2550  * example netlogon/netlogon_control.c
2551  ***************************************************************/
2552
2553 NET_API_STATUS I_NetLogonControl(const char * server_name /* [in] */,
2554                                  uint32_t function_code /* [in] */,
2555                                  uint32_t query_level /* [in] */,
2556                                  uint8_t **buffer /* [out] [ref] */);
2557
2558 /************************************************************//**
2559  *
2560  * I_NetLogonControl2
2561  *
2562  * @brief Control various aspects of the NETLOGON service
2563  *
2564  * @param[in] server_name The server name to connect to
2565  * @param[in] function_code The function code to call on the server
2566  * @param[in] query_level The level of the NETLOGON_INFO structure returned
2567  * @param[in] data The buffer containing information related to the function code
2568  * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2569  * @return NET_API_STATUS
2570  *
2571  * example netlogon/netlogon_control2.c
2572  ***************************************************************/
2573
2574 NET_API_STATUS I_NetLogonControl2(const char * server_name /* [in] */,
2575                                   uint32_t function_code /* [in] */,
2576                                   uint32_t query_level /* [in] */,
2577                                   uint8_t *data /* [in] [ref] */,
2578                                   uint8_t **buffer /* [out] [ref] */);
2579
2580 #ifdef __cplusplus
2581 }
2582 #endif /* __cplusplus */
2583
2584 #endif /* __LIB_NETAPI_H__ */