ctdb-server: Clean up connection tracking functions
[samba4-gss.git] / source3 / lib / netapi / netapi.h
blob80f5482b24124284cfe0b3d38065ad1d4246fea0
1 /*
2 * Unix SMB/CIFS implementation.
3 * NetApi Support
4 * Copyright (C) Guenther Deschner 2007-2009
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.
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.
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/>.
20 #ifndef __LIB_NETAPI_H__
21 #define __LIB_NETAPI_H__
23 #ifdef __cplusplus
24 extern "C" {
25 #endif /* __cplusplus */
27 struct cli_credentials;
29 /****************************************************************
30 NET_API_STATUS
31 ****************************************************************/
32 typedef enum {
33 NET_API_STATUS_SUCCESS = 0
34 } NET_API_STATUS;
36 #define ERROR_MORE_DATA ( 234L )
38 #define ENCRYPTED_PWLEN ( 16 )
40 /****************************************************************
41 ****************************************************************/
43 #ifndef _HEADER_misc
45 struct GUID {
46 uint32_t time_low;
47 uint16_t time_mid;
48 uint16_t time_hi_and_version;
49 uint8_t clock_seq[2];
50 uint8_t node[6];
53 #endif /* _HEADER_misc */
55 #ifndef _HEADER_libnetapi
57 #ifndef MAXSUBAUTHS
58 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
59 #endif
61 struct domsid {
62 uint8_t sid_rev_num;
63 uint8_t num_auths;
64 uint8_t id_auth[6];
65 uint32_t sub_auths[MAXSUBAUTHS];
68 struct DOMAIN_CONTROLLER_INFO {
69 const char * domain_controller_name;
70 const char * domain_controller_address;
71 uint32_t domain_controller_address_type;
72 struct GUID domain_guid;
73 const char * domain_name;
74 const char * dns_forest_name;
75 uint32_t flags;
76 const char * dc_site_name;
77 const char * client_site_name;
80 /* bitmap NetJoinFlags */
81 #define NETSETUP_JOIN_DOMAIN ( 0x00000001 )
82 #define NETSETUP_ACCT_CREATE ( 0x00000002 )
83 #define NETSETUP_ACCT_DELETE ( 0x00000004 )
84 #define NETSETUP_WIN9X_UPGRADE ( 0x00000010 )
85 #define NETSETUP_DOMAIN_JOIN_IF_JOINED ( 0x00000020 )
86 #define NETSETUP_JOIN_UNSECURE ( 0x00000040 )
87 #define NETSETUP_MACHINE_PWD_PASSED ( 0x00000080 )
88 #define NETSETUP_DEFER_SPN_SET ( 0x00000100 )
89 #define NETSETUP_JOIN_DC_ACCOUNT ( 0x00000200 )
90 #define NETSETUP_JOIN_WITH_NEW_NAME ( 0x00000400 )
91 #define NETSETUP_JOIN_READONLY ( 0x00000800 )
92 #define NETSETUP_AMBIGUOUS_DC ( 0x00001000 )
93 #define NETSETUP_NO_NETLOGON_CACHE ( 0x00002000 )
94 #define NETSETUP_DONT_CONTROL_SERVICES ( 0x00004000 )
95 #define NETSETUP_SET_MACHINE_NAME ( 0x00008000 )
96 #define NETSETUP_FORCE_SPN_SET ( 0x00010000 )
97 #define NETSETUP_NO_ACCT_REUSE ( 0x00020000 )
98 #define NETSETUP_INSTALL_INVOCATION ( 0x00040000 )
99 #define NETSETUP_IGNORE_UNSUPPORTED_FLAGS ( 0x10000000 )
101 /* bitmap NetProvisionFlags */
102 #define NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT ( 0x00000001 )
103 #define NETSETUP_PROVISION_REUSE_ACCOUNT ( 0x00000002 )
104 #define NETSETUP_PROVISION_USE_DEFAULT_PASSWORD ( 0x00000004 )
105 #define NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH ( 0x00000008 )
106 #define NETSETUP_PROVISION_ROOT_CA_CERTS ( 0x00000010 )
108 /* bitmap NetProvisionJoinFlags */
109 #define NETSETUP_PROVISION_ONLINE_CALLER ( 0x40000000 )
111 #define FILTER_TEMP_DUPLICATE_ACCOUNT ( 0x0001 )
112 #define FILTER_NORMAL_ACCOUNT ( 0x0002 )
113 #define FILTER_INTERDOMAIN_TRUST_ACCOUNT ( 0x0008 )
114 #define FILTER_WORKSTATION_TRUST_ACCOUNT ( 0x0010 )
115 #define FILTER_SERVER_TRUST_ACCOUNT ( 0x0020 )
117 #define TIMEQ_FOREVER ( (uint32_t)-1L )
119 enum NETSETUP_JOIN_STATUS {
120 NetSetupUnknownStatus=0,
121 NetSetupUnjoined=1,
122 NetSetupWorkgroupName=2,
123 NetSetupDomainName=3
126 struct SERVER_INFO_100 {
127 uint32_t sv100_platform_id;
128 const char * sv100_name;
131 struct SERVER_INFO_101 {
132 uint32_t sv101_platform_id;
133 const char * sv101_name;
134 uint32_t sv101_version_major;
135 uint32_t sv101_version_minor;
136 uint32_t sv101_type;
137 const char * sv101_comment;
140 struct SERVER_INFO_102 {
141 uint32_t sv102_platform_id;
142 const char * sv102_name;
143 uint32_t sv102_version_major;
144 uint32_t sv102_version_minor;
145 uint32_t sv102_type;
146 const char * sv102_comment;
147 uint32_t sv102_users;
148 uint32_t sv102_disc;
149 uint8_t sv102_hidden;
150 uint32_t sv102_announce;
151 uint32_t sv102_anndelta;
152 uint32_t sv102_licenses;
153 const char * sv102_userpath;
156 struct SERVER_INFO_402 {
157 uint32_t sv402_ulist_mtime;
158 uint32_t sv402_glist_mtime;
159 uint32_t sv402_alist_mtime;
160 const char * sv402_alerts;
161 uint32_t sv402_security;
162 uint32_t sv402_numadmin;
163 uint32_t sv402_lanmask;
164 const char * sv402_guestacct;
165 uint32_t sv402_chdevs;
166 uint32_t sv402_chdevq;
167 uint32_t sv402_chdevjobs;
168 uint32_t sv402_connections;
169 uint32_t sv402_shares;
170 uint32_t sv402_openfiles;
171 uint32_t sv402_sessopens;
172 uint32_t sv402_sessvcs;
173 uint32_t sv402_sessreqs;
174 uint32_t sv402_opensearch;
175 uint32_t sv402_activelocks;
176 uint32_t sv402_numreqbuf;
177 uint32_t sv402_sizreqbuf;
178 uint32_t sv402_numbigbuf;
179 uint32_t sv402_numfiletasks;
180 uint32_t sv402_alertsched;
181 uint32_t sv402_erroralert;
182 uint32_t sv402_logonalert;
183 uint32_t sv402_accessalert;
184 uint32_t sv402_diskalert;
185 uint32_t sv402_netioalert;
186 uint32_t sv402_maxauditsz;
187 const char * sv402_srvheuristics;
190 struct SERVER_INFO_403 {
191 uint32_t sv403_ulist_mtime;
192 uint32_t sv403_glist_mtime;
193 uint32_t sv403_alist_mtime;
194 const char * sv403_alerts;
195 uint32_t sv403_security;
196 uint32_t sv403_numadmin;
197 uint32_t sv403_lanmask;
198 const char * sv403_guestacct;
199 uint32_t sv403_chdevs;
200 uint32_t sv403_chdevq;
201 uint32_t sv403_chdevjobs;
202 uint32_t sv403_connections;
203 uint32_t sv403_shares;
204 uint32_t sv403_openfiles;
205 uint32_t sv403_sessopens;
206 uint32_t sv403_sessvcs;
207 uint32_t sv403_sessreqs;
208 uint32_t sv403_opensearch;
209 uint32_t sv403_activelocks;
210 uint32_t sv403_numreqbuf;
211 uint32_t sv403_sizreqbuf;
212 uint32_t sv403_numbigbuf;
213 uint32_t sv403_numfiletasks;
214 uint32_t sv403_alertsched;
215 uint32_t sv403_erroralert;
216 uint32_t sv403_logonalert;
217 uint32_t sv403_accessalert;
218 uint32_t sv403_diskalert;
219 uint32_t sv403_netioalert;
220 uint32_t sv403_maxauditsz;
221 const char * sv403_srvheuristics;
222 uint32_t sv403_auditedevents;
223 uint32_t sv403_autoprofile;
224 const char * sv403_autopath;
227 struct SERVER_INFO_502 {
228 uint32_t sv502_sessopens;
229 uint32_t sv502_sessvcs;
230 uint32_t sv502_opensearch;
231 uint32_t sv502_sizreqbuf;
232 uint32_t sv502_initworkitems;
233 uint32_t sv502_maxworkitems;
234 uint32_t sv502_rawworkitems;
235 uint32_t sv502_irpstacksize;
236 uint32_t sv502_maxrawbuflen;
237 uint32_t sv502_sessusers;
238 uint32_t sv502_sessconns;
239 uint32_t sv502_maxpagedmemoryusage;
240 uint32_t sv502_maxnonpagedmemoryusage;
241 uint8_t sv502_enablesoftcompat;
242 uint8_t sv502_enableforcedlogoff;
243 uint8_t sv502_timesource;
244 uint8_t sv502_acceptdownlevelapis;
245 uint8_t sv502_lmannounce;
248 struct SERVER_INFO_503 {
249 uint32_t sv503_sessopens;
250 uint32_t sv503_sessvcs;
251 uint32_t sv503_opensearch;
252 uint32_t sv503_sizreqbuf;
253 uint32_t sv503_initworkitems;
254 uint32_t sv503_maxworkitems;
255 uint32_t sv503_rawworkitems;
256 uint32_t sv503_irpstacksize;
257 uint32_t sv503_maxrawbuflen;
258 uint32_t sv503_sessusers;
259 uint32_t sv503_sessconns;
260 uint32_t sv503_maxpagedmemoryusage;
261 uint32_t sv503_maxnonpagedmemoryusage;
262 uint8_t sv503_enablesoftcompat;
263 uint8_t sv503_enableforcedlogoff;
264 uint8_t sv503_timesource;
265 uint8_t sv503_acceptdownlevelapis;
266 uint8_t sv503_lmannounce;
267 const char * sv503_domain;
268 uint32_t sv503_maxcopyreadlen;
269 uint32_t sv503_maxcopywritelen;
270 uint32_t sv503_minkeepsearch;
271 uint32_t sv503_maxkeepsearch;
272 uint32_t sv503_minkeepcomplsearch;
273 uint32_t sv503_maxkeepcomplsearch;
274 uint32_t sv503_threadcountadd;
275 uint32_t sv503_numblockthreads;
276 uint32_t sv503_scavtimeout;
277 uint32_t sv503_minrcvqueue;
278 uint32_t sv503_minfreeworkitems;
279 uint32_t sv503_xactmemsize;
280 uint32_t sv503_threadpriority;
281 uint32_t sv503_maxmpxct;
282 uint32_t sv503_oplockbreakwait;
283 uint32_t sv503_oplockbreakresponsewait;
284 uint8_t sv503_enableoplocks;
285 uint8_t sv503_enableoplockforceclose;
286 uint8_t sv503_enablefcbopens;
287 uint8_t sv503_enableraw;
288 uint8_t sv503_enablesharednetdrives;
289 uint32_t sv503_minfreeconnections;
290 uint32_t sv503_maxfreeconnections;
293 struct SERVER_INFO_599 {
294 uint32_t sv599_sessopens;
295 uint32_t sv599_sessvcs;
296 uint32_t sv599_opensearch;
297 uint32_t sv599_sizreqbuf;
298 uint32_t sv599_initworkitems;
299 uint32_t sv599_maxworkitems;
300 uint32_t sv599_rawworkitems;
301 uint32_t sv599_irpstacksize;
302 uint32_t sv599_maxrawbuflen;
303 uint32_t sv599_sessusers;
304 uint32_t sv599_sessconns;
305 uint32_t sv599_maxpagedmemoryusage;
306 uint32_t sv599_maxnonpagedmemoryusage;
307 uint8_t sv599_enablesoftcompat;
308 uint8_t sv599_enableforcedlogoff;
309 uint8_t sv599_timesource;
310 uint8_t sv599_acceptdownlevelapis;
311 uint8_t sv599_lmannounce;
312 const char * sv599_domain;
313 uint32_t sv599_maxcopyreadlen;
314 uint32_t sv599_maxcopywritelen;
315 uint32_t sv599_minkeepsearch;
316 uint32_t sv599_maxkeepsearch;
317 uint32_t sv599_minkeepcomplsearch;
318 uint32_t sv599_maxkeepcomplsearch;
319 uint32_t sv599_threadcountadd;
320 uint32_t sv599_numblockthreads;
321 uint32_t sv599_scavtimeout;
322 uint32_t sv599_minrcvqueue;
323 uint32_t sv599_minfreeworkitems;
324 uint32_t sv599_xactmemsize;
325 uint32_t sv599_threadpriority;
326 uint32_t sv599_maxmpxct;
327 uint32_t sv599_oplockbreakwait;
328 uint32_t sv599_oplockbreakresponsewait;
329 uint8_t sv599_enableoplocks;
330 uint8_t sv599_enableoplockforceclose;
331 uint8_t sv599_enablefcbopens;
332 uint8_t sv599_enableraw;
333 uint8_t sv599_enablesharednetdrives;
334 uint32_t sv599_minfreeconnections;
335 uint32_t sv599_maxfreeconnections;
336 uint32_t sv599_initsesstable;
337 uint32_t sv599_initconntable;
338 uint32_t sv599_initfiletable;
339 uint32_t sv599_initsearchtable;
340 uint32_t sv599_alertschedule;
341 uint32_t sv599_errorthreshold;
342 uint32_t sv599_networkerrorthreshold;
343 uint32_t sv599_diskspacethreshold;
344 uint32_t sv599_reserved;
345 uint32_t sv599_maxlinkdelay;
346 uint32_t sv599_minlinkthroughput;
347 uint32_t sv599_linkinfovalidtime;
348 uint32_t sv599_scavqosinfoupdatetime;
349 uint32_t sv599_maxworkitemidletime;
352 struct SERVER_INFO_598 {
353 uint32_t sv598_maxrawworkitems;
354 uint32_t sv598_maxthreadsperqueue;
355 uint32_t sv598_producttype;
356 uint32_t sv598_serversize;
357 uint32_t sv598_connectionlessautodisc;
358 uint32_t sv598_sharingviolationretries;
359 uint32_t sv598_sharingviolationdelay;
360 uint32_t sv598_maxglobalopensearch;
361 uint32_t sv598_removeduplicatesearches;
362 uint32_t sv598_lockviolationoffset;
363 uint32_t sv598_lockviolationdelay;
364 uint32_t sv598_mdlreadswitchover;
365 uint32_t sv598_cachedopenlimit;
366 uint32_t sv598_otherqueueaffinity;
367 uint8_t sv598_restrictnullsessaccess;
368 uint8_t sv598_enablewfw311directipx;
369 uint32_t sv598_queuesamplesecs;
370 uint32_t sv598_balancecount;
371 uint32_t sv598_preferredaffinity;
372 uint32_t sv598_maxfreerfcbs;
373 uint32_t sv598_maxfreemfcbs;
374 uint32_t sv598_maxfreelfcbs;
375 uint32_t sv598_maxfreepagedpoolchunks;
376 uint32_t sv598_minpagedpoolchunksize;
377 uint32_t sv598_maxpagedpoolchunksize;
378 uint8_t sv598_sendsfrompreferredprocessor;
379 uint32_t sv598_cacheddirectorylimit;
380 uint32_t sv598_maxcopylength;
381 uint8_t sv598_enablecompression;
382 uint8_t sv598_autosharewks;
383 uint8_t sv598_autoshareserver;
384 uint8_t sv598_enablesecuritysignature;
385 uint8_t sv598_requiresecuritysignature;
386 uint32_t sv598_minclientbuffersize;
387 struct GUID sv598_serverguid;
388 uint32_t sv598_ConnectionNoSessionsTimeout;
389 uint32_t sv598_IdleThreadTimeOut;
390 uint8_t sv598_enableW9xsecuritysignature;
391 uint8_t sv598_enforcekerberosreauthentication;
392 uint8_t sv598_disabledos;
393 uint32_t sv598_lowdiskspaceminimum;
394 uint8_t sv598_disablestrictnamechecking;
397 struct SERVER_INFO_1005 {
398 const char * sv1005_comment;
401 struct SERVER_INFO_1107 {
402 uint32_t sv1107_users;
405 struct SERVER_INFO_1010 {
406 int32_t sv1010_disc;
409 struct SERVER_INFO_1016 {
410 uint8_t sv1016_hidden;
413 struct SERVER_INFO_1017 {
414 uint32_t sv1017_announce;
417 struct SERVER_INFO_1018 {
418 uint32_t sv1018_anndelta;
421 struct SERVER_INFO_1501 {
422 uint32_t sv1501_sessopens;
425 struct SERVER_INFO_1502 {
426 uint32_t sv1502_sessvcs;
429 struct SERVER_INFO_1503 {
430 uint32_t sv1503_opensearch;
433 struct SERVER_INFO_1506 {
434 uint32_t sv1506_maxworkitems;
437 struct SERVER_INFO_1509 {
438 uint32_t sv1509_maxrawbuflen;
441 struct SERVER_INFO_1510 {
442 uint32_t sv1510_sessusers;
445 struct SERVER_INFO_1511 {
446 uint32_t sv1511_sessconns;
449 struct SERVER_INFO_1512 {
450 uint32_t sv1512_maxnonpagedmemoryusage;
453 struct SERVER_INFO_1513 {
454 uint32_t sv1513_maxpagedmemoryusage;
457 struct SERVER_INFO_1514 {
458 uint8_t sv1514_enablesoftcompat;
461 struct SERVER_INFO_1515 {
462 uint8_t sv1515_enableforcedlogoff;
465 struct SERVER_INFO_1516 {
466 uint8_t sv1516_timesource;
469 struct SERVER_INFO_1518 {
470 uint8_t sv1518_lmannounce;
473 struct SERVER_INFO_1520 {
474 uint32_t sv1520_maxcopyreadlen;
477 struct SERVER_INFO_1521 {
478 uint32_t sv1521_maxcopywritelen;
481 struct SERVER_INFO_1522 {
482 uint32_t sv1522_minkeepsearch;
485 struct SERVER_INFO_1523 {
486 uint32_t sv1523_maxkeepsearch;
489 struct SERVER_INFO_1524 {
490 uint32_t sv1524_minkeepcomplsearch;
493 struct SERVER_INFO_1525 {
494 uint32_t sv1525_maxkeepcomplsearch;
497 struct SERVER_INFO_1528 {
498 uint32_t sv1528_scavtimeout;
501 struct SERVER_INFO_1529 {
502 uint32_t sv1529_minrcvqueue;
505 struct SERVER_INFO_1530 {
506 uint32_t sv1530_minfreeworkitems;
509 struct SERVER_INFO_1533 {
510 uint32_t sv1533_maxmpxct;
513 struct SERVER_INFO_1534 {
514 uint32_t sv1534_oplockbreakwait;
517 struct SERVER_INFO_1535 {
518 uint32_t sv1535_oplockbreakresponsewait;
521 struct SERVER_INFO_1536 {
522 uint8_t sv1536_enableoplocks;
525 struct SERVER_INFO_1537 {
526 uint8_t sv1537_enableoplockforceclose;
529 struct SERVER_INFO_1538 {
530 uint8_t sv1538_enablefcbopens;
533 struct SERVER_INFO_1539 {
534 uint8_t sv1539_enableraw;
537 struct SERVER_INFO_1540 {
538 uint8_t sv1540_enablesharednetdrives;
541 struct SERVER_INFO_1541 {
542 uint8_t sv1541_minfreeconnections;
545 struct SERVER_INFO_1542 {
546 uint8_t sv1542_maxfreeconnections;
549 struct SERVER_INFO_1543 {
550 uint32_t sv1543_initsesstable;
553 struct SERVER_INFO_1544 {
554 uint32_t sv1544_initconntable;
557 struct SERVER_INFO_1545 {
558 uint32_t sv1545_initfiletable;
561 struct SERVER_INFO_1546 {
562 uint32_t sv1546_initsearchtable;
565 struct SERVER_INFO_1547 {
566 uint32_t sv1547_alertschedule;
569 struct SERVER_INFO_1548 {
570 uint32_t sv1548_errorthreshold;
573 struct SERVER_INFO_1549 {
574 uint32_t sv1549_networkerrorthreshold;
577 struct SERVER_INFO_1550 {
578 uint32_t sv1550_diskspacethreshold;
581 struct SERVER_INFO_1552 {
582 uint32_t sv1552_maxlinkdelay;
585 struct SERVER_INFO_1553 {
586 uint32_t sv1553_minlinkthroughput;
589 struct SERVER_INFO_1554 {
590 uint32_t sv1554_linkinfovalidtime;
593 struct SERVER_INFO_1555 {
594 uint32_t sv1555_scavqosinfoupdatetime;
597 struct SERVER_INFO_1556 {
598 uint32_t sv1556_maxworkitemidletime;
601 struct SERVER_INFO_1557 {
602 uint32_t sv1557_maxrawworkitems;
605 struct SERVER_INFO_1560 {
606 uint32_t sv1560_producttype;
609 struct SERVER_INFO_1561 {
610 uint32_t sv1561_serversize;
613 struct SERVER_INFO_1562 {
614 uint32_t sv1562_connectionlessautodisc;
617 struct SERVER_INFO_1563 {
618 uint32_t sv1563_sharingviolationretries;
621 struct SERVER_INFO_1564 {
622 uint32_t sv1564_sharingviolationdelay;
625 struct SERVER_INFO_1565 {
626 uint32_t sv1565_maxglobalopensearch;
629 struct SERVER_INFO_1566 {
630 uint8_t sv1566_removeduplicatesearches;
633 struct SERVER_INFO_1567 {
634 uint32_t sv1567_lockviolationretries;
637 struct SERVER_INFO_1568 {
638 uint32_t sv1568_lockviolationoffset;
641 struct SERVER_INFO_1569 {
642 uint32_t sv1569_lockviolationdelay;
645 struct SERVER_INFO_1570 {
646 uint32_t sv1570_mdlreadswitchover;
649 struct SERVER_INFO_1571 {
650 uint32_t sv1571_cachedopenlimit;
653 struct SERVER_INFO_1572 {
654 uint32_t sv1572_criticalthreads;
657 struct SERVER_INFO_1573 {
658 uint32_t sv1573_restrictnullsessaccess;
661 struct SERVER_INFO_1574 {
662 uint32_t sv1574_enablewfw311directipx;
665 struct SERVER_INFO_1575 {
666 uint32_t sv1575_otherqueueaffinity;
669 struct SERVER_INFO_1576 {
670 uint32_t sv1576_queuesamplesecs;
673 struct SERVER_INFO_1577 {
674 uint32_t sv1577_balancecount;
677 struct SERVER_INFO_1578 {
678 uint32_t sv1578_preferredaffinity;
681 struct SERVER_INFO_1579 {
682 uint32_t sv1579_maxfreerfcbs;
685 struct SERVER_INFO_1580 {
686 uint32_t sv1580_maxfreemfcbs;
689 struct SERVER_INFO_1581 {
690 uint32_t sv1581_maxfreemlcbs;
693 struct SERVER_INFO_1582 {
694 uint32_t sv1582_maxfreepagedpoolchunks;
697 struct SERVER_INFO_1583 {
698 uint32_t sv1583_minpagedpoolchunksize;
701 struct SERVER_INFO_1584 {
702 uint32_t sv1584_maxpagedpoolchunksize;
705 struct SERVER_INFO_1585 {
706 uint8_t sv1585_sendsfrompreferredprocessor;
709 struct SERVER_INFO_1586 {
710 uint32_t sv1586_maxthreadsperqueue;
713 struct SERVER_INFO_1587 {
714 uint32_t sv1587_cacheddirectorylimit;
717 struct SERVER_INFO_1588 {
718 uint32_t sv1588_maxcopylength;
721 struct SERVER_INFO_1590 {
722 uint32_t sv1590_enablecompression;
725 struct SERVER_INFO_1591 {
726 uint32_t sv1591_autosharewks;
729 struct SERVER_INFO_1592 {
730 uint32_t sv1592_autosharewks;
733 struct SERVER_INFO_1593 {
734 uint32_t sv1593_enablesecuritysignature;
737 struct SERVER_INFO_1594 {
738 uint32_t sv1594_requiresecuritysignature;
741 struct SERVER_INFO_1595 {
742 uint32_t sv1595_minclientbuffersize;
745 struct SERVER_INFO_1596 {
746 uint32_t sv1596_ConnectionNoSessionsTimeout;
749 struct SERVER_INFO_1597 {
750 uint32_t sv1597_IdleThreadTimeOut;
753 struct SERVER_INFO_1598 {
754 uint32_t sv1598_enableW9xsecuritysignature;
757 struct SERVER_INFO_1599 {
758 uint8_t sv1598_enforcekerberosreauthentication;
761 struct SERVER_INFO_1600 {
762 uint8_t sv1598_disabledos;
765 struct SERVER_INFO_1601 {
766 uint32_t sv1598_lowdiskspaceminimum;
769 struct SERVER_INFO_1602 {
770 uint8_t sv_1598_disablestrictnamechecking;
773 struct USER_INFO_0 {
774 const char * usri0_name;
777 #define USER_PRIV_GUEST ( 0 )
778 #define USER_PRIV_USER ( 1 )
779 #define USER_PRIV_ADMIN ( 2 )
781 struct USER_INFO_1 {
782 const char * usri1_name;
783 const char * usri1_password;
784 uint32_t usri1_password_age;
785 uint32_t usri1_priv;
786 const char * usri1_home_dir;
787 const char * usri1_comment;
788 uint32_t usri1_flags;
789 const char * usri1_script_path;
792 #define AF_OP_PRINT ( 0x1 )
793 #define AF_OP_COMM ( 0x2 )
794 #define AF_OP_SERVER ( 0x4 )
795 #define AF_OP_ACCOUNTS ( 0x8 )
797 struct USER_INFO_2 {
798 const char * usri2_name;
799 const char * usri2_password;
800 uint32_t usri2_password_age;
801 uint32_t usri2_priv;
802 const char * usri2_home_dir;
803 const char * usri2_comment;
804 uint32_t usri2_flags;
805 const char * usri2_script_path;
806 uint32_t usri2_auth_flags;
807 const char * usri2_full_name;
808 const char * usri2_usr_comment;
809 const char * usri2_parms;
810 const char * usri2_workstations;
811 uint32_t usri2_last_logon;
812 uint32_t usri2_last_logoff;
813 uint32_t usri2_acct_expires;
814 uint32_t usri2_max_storage;
815 uint32_t usri2_units_per_week;
816 uint8_t *usri2_logon_hours;/* [unique] */
817 uint32_t usri2_bad_pw_count;
818 uint32_t usri2_num_logons;
819 const char * usri2_logon_server;
820 uint32_t usri2_country_code;
821 uint32_t usri2_code_page;
824 struct USER_INFO_3 {
825 const char * usri3_name;
826 uint32_t usri3_password_age;
827 uint32_t usri3_priv;
828 const char * usri3_home_dir;
829 const char * usri3_comment;
830 uint32_t usri3_flags;
831 const char * usri3_script_path;
832 uint32_t usri3_auth_flags;
833 const char * usri3_full_name;
834 const char * usri3_usr_comment;
835 const char * usri3_parms;
836 const char * usri3_workstations;
837 uint32_t usri3_last_logon;
838 uint32_t usri3_last_logoff;
839 uint32_t usri3_acct_expires;
840 uint32_t usri3_max_storage;
841 uint32_t usri3_units_per_week;
842 uint8_t *usri3_logon_hours;/* [unique] */
843 uint32_t usri3_bad_pw_count;
844 uint32_t usri3_num_logons;
845 const char * usri3_logon_server;
846 uint32_t usri3_country_code;
847 uint32_t usri3_code_page;
848 uint32_t usri3_user_id;
849 uint32_t usri3_primary_group_id;
850 const char * usri3_profile;
851 const char * usri3_home_dir_drive;
852 uint32_t usri3_password_expired;
855 struct USER_INFO_4 {
856 const char * usri4_name;
857 const char * usri4_password;
858 uint32_t usri4_password_age;
859 uint32_t usri4_priv;
860 const char * usri4_home_dir;
861 const char * usri4_comment;
862 uint32_t usri4_flags;
863 const char * usri4_script_path;
864 uint32_t usri4_auth_flags;
865 const char * usri4_full_name;
866 const char * usri4_usr_comment;
867 const char * usri4_parms;
868 const char * usri4_workstations;
869 uint32_t usri4_last_logon;
870 uint32_t usri4_last_logoff;
871 uint32_t usri4_acct_expires;
872 uint32_t usri4_max_storage;
873 uint32_t usri4_units_per_week;
874 uint8_t *usri4_logon_hours;/* [unique] */
875 uint32_t usri4_bad_pw_count;
876 uint32_t usri4_num_logons;
877 const char * usri4_logon_server;
878 uint32_t usri4_country_code;
879 uint32_t usri4_code_page;
880 struct domsid *usri4_user_sid;/* [unique] */
881 uint32_t usri4_primary_group_id;
882 const char * usri4_profile;
883 const char * usri4_home_dir_drive;
884 uint32_t usri4_password_expired;
887 struct USER_INFO_10 {
888 const char * usri10_name;
889 const char * usri10_comment;
890 const char * usri10_usr_comment;
891 const char * usri10_full_name;
894 struct USER_INFO_11 {
895 const char * usri11_name;
896 const char * usri11_comment;
897 const char * usri11_usr_comment;
898 const char * usri11_full_name;
899 uint32_t usri11_priv;
900 uint32_t usri11_auth_flags;
901 uint32_t usri11_password_age;
902 const char * usri11_home_dir;
903 const char * usri11_parms;
904 uint32_t usri11_last_logon;
905 uint32_t usri11_last_logoff;
906 uint32_t usri11_bad_pw_count;
907 uint32_t usri11_num_logons;
908 const char * usri11_logon_server;
909 uint32_t usri11_country_code;
910 const char * usri11_workstations;
911 uint32_t usri11_max_storage;
912 uint32_t usri11_units_per_week;
913 uint8_t *usri11_logon_hours;/* [unique] */
914 uint32_t usri11_code_page;
917 struct USER_INFO_20 {
918 const char * usri20_name;
919 const char * usri20_full_name;
920 const char * usri20_comment;
921 uint32_t usri20_flags;
922 uint32_t usri20_user_id;
925 struct USER_INFO_21 {
926 uint8_t *usri21_password;
929 struct USER_INFO_22 {
930 const char * usri22_name;
931 uint8_t *usri22_password;
932 uint32_t usri22_password_age;
933 uint32_t usri22_priv;
934 const char * usri22_home_dir;
935 const char * usri22_comment;
936 uint32_t usri22_flags;
937 uint32_t usri22_script_path;
938 uint32_t usri22_auth_flags;
939 const char * usri22_full_name;
940 const char * usri22_usr_comment;
941 const char * usri22_parms;
942 const char * usri22_workstations;
943 uint32_t usri22_last_logon;
944 uint32_t usri22_last_logoff;
945 uint32_t usri22_acct_expires;
946 uint32_t usri22_max_storage;
947 uint32_t usri22_units_per_week;
948 uint8_t *usri22_logon_hours;/* [unique] */
949 uint32_t usri22_bad_pw_count;
950 uint32_t usri22_num_logons;
951 const char * usri22_logon_server;
952 uint32_t usri22_country_code;
953 uint32_t usri22_code_page;
956 struct USER_INFO_23 {
957 const char * usri23_name;
958 const char * usri23_full_name;
959 const char * usri23_comment;
960 uint32_t usri23_flags;
961 struct domsid *usri23_user_sid;/* [unique] */
964 struct USER_INFO_1003 {
965 const char * usri1003_password;
968 struct USER_INFO_1005 {
969 uint32_t usri1005_priv;
972 struct USER_INFO_1006 {
973 const char * usri1006_home_dir;
976 struct USER_INFO_1007 {
977 const char * usri1007_comment;
980 struct USER_INFO_1008 {
981 uint32_t usri1008_flags;
984 struct USER_INFO_1009 {
985 const char * usri1009_script_path;
988 struct USER_INFO_1010 {
989 uint32_t usri1010_auth_flags;
992 struct USER_INFO_1011 {
993 const char * usri1011_full_name;
996 struct USER_INFO_1012 {
997 const char * usri1012_usr_comment;
1000 struct USER_INFO_1013 {
1001 const char * usri1013_parms;
1004 struct USER_INFO_1014 {
1005 const char * usri1014_workstations;
1008 struct USER_INFO_1017 {
1009 uint32_t usri1017_acct_expires;
1012 struct USER_INFO_1018 {
1013 uint32_t usri1018_max_storage;
1016 struct USER_INFO_1020 {
1017 uint32_t usri1020_units_per_week;
1018 uint8_t *usri1020_logon_hours;/* [unique] */
1021 struct USER_INFO_1023 {
1022 const char * usri1023_logon_server;
1025 struct USER_INFO_1024 {
1026 uint32_t usri1024_country_code;
1029 struct USER_INFO_1025 {
1030 uint32_t usri1025_code_page;
1033 struct USER_INFO_1051 {
1034 uint32_t usri1051_primary_group_id;
1037 struct USER_INFO_1052 {
1038 const char * usri1052_profile;
1041 struct USER_INFO_1053 {
1042 const char * usri1053_home_dir_drive;
1045 struct USER_MODALS_INFO_0 {
1046 uint32_t usrmod0_min_passwd_len;
1047 uint32_t usrmod0_max_passwd_age;
1048 uint32_t usrmod0_min_passwd_age;
1049 uint32_t usrmod0_force_logoff;
1050 uint32_t usrmod0_password_hist_len;
1053 struct USER_MODALS_INFO_1 {
1054 uint32_t usrmod1_role;
1055 const char * usrmod1_primary;
1058 struct USER_MODALS_INFO_2 {
1059 const char * usrmod2_domain_name;
1060 struct domsid *usrmod2_domain_id;/* [unique] */
1063 struct USER_MODALS_INFO_3 {
1064 uint32_t usrmod3_lockout_duration;
1065 uint32_t usrmod3_lockout_observation_window;
1066 uint32_t usrmod3_lockout_threshold;
1069 struct USER_MODALS_INFO_1001 {
1070 uint32_t usrmod1001_min_passwd_len;
1073 struct USER_MODALS_INFO_1002 {
1074 uint32_t usrmod1002_max_passwd_age;
1077 struct USER_MODALS_INFO_1003 {
1078 uint32_t usrmod1003_min_passwd_age;
1081 struct USER_MODALS_INFO_1004 {
1082 uint32_t usrmod1004_force_logoff;
1085 struct USER_MODALS_INFO_1005 {
1086 uint32_t usrmod1005_password_hist_len;
1089 struct USER_MODALS_INFO_1006 {
1090 uint32_t usrmod1006_role;
1093 struct USER_MODALS_INFO_1007 {
1094 const char * usrmod1007_primary;
1097 struct NET_DISPLAY_USER {
1098 const char * usri1_name;
1099 const char * usri1_comment;
1100 uint32_t usri1_flags;
1101 const char * usri1_full_name;
1102 uint32_t usri1_user_id;
1103 uint32_t usri1_next_index;
1106 struct NET_DISPLAY_MACHINE {
1107 const char * usri2_name;
1108 const char * usri2_comment;
1109 uint32_t usri2_flags;
1110 uint32_t usri2_user_id;
1111 uint32_t usri2_next_index;
1114 struct NET_DISPLAY_GROUP {
1115 const char * grpi3_name;
1116 const char * grpi3_comment;
1117 uint32_t grpi3_group_id;
1118 uint32_t grpi3_attributes;
1119 uint32_t grpi3_next_index;
1122 struct GROUP_INFO_0 {
1123 const char * grpi0_name;
1126 struct GROUP_INFO_1 {
1127 const char * grpi1_name;
1128 const char * grpi1_comment;
1131 struct GROUP_INFO_2 {
1132 const char * grpi2_name;
1133 const char * grpi2_comment;
1134 uint32_t grpi2_group_id;
1135 uint32_t grpi2_attributes;
1138 struct GROUP_INFO_3 {
1139 const char * grpi3_name;
1140 const char * grpi3_comment;
1141 struct domsid * grpi3_group_sid;
1142 uint32_t grpi3_attributes;
1145 struct GROUP_INFO_1002 {
1146 const char * grpi1002_comment;
1149 struct GROUP_INFO_1005 {
1150 uint32_t grpi1005_attributes;
1153 struct GROUP_USERS_INFO_0 {
1154 const char * grui0_name;
1157 struct GROUP_USERS_INFO_1 {
1158 const char * grui1_name;
1159 uint32_t grui1_attributes;
1162 struct LOCALGROUP_INFO_0 {
1163 const char * lgrpi0_name;
1166 struct LOCALGROUP_INFO_1 {
1167 const char * lgrpi1_name;
1168 const char * lgrpi1_comment;
1171 struct LOCALGROUP_INFO_1002 {
1172 const char * lgrpi1002_comment;
1175 enum SID_NAME_USE {
1176 SidTypeUser=1,
1177 SidTypeGroup=2,
1178 SidTypeDomain=3,
1179 SidTypeAlias=4,
1180 SidTypeWellKnownGroup=5,
1181 SidTypeDeletedAccount=6,
1182 SidTypeInvalid=7,
1183 SidTypeUnknown=8,
1184 SidTypeComputer=9,
1185 SidTypeLabel=10
1188 struct LOCALGROUP_MEMBERS_INFO_0 {
1189 struct domsid *lgrmi0_sid;/* [unique] */
1192 struct LOCALGROUP_MEMBERS_INFO_1 {
1193 struct domsid *lgrmi1_sid;/* [unique] */
1194 enum SID_NAME_USE lgrmi1_sidusage;
1195 const char * lgrmi1_name;
1198 struct LOCALGROUP_MEMBERS_INFO_2 {
1199 struct domsid *lgrmi2_sid;/* [unique] */
1200 enum SID_NAME_USE lgrmi2_sidusage;
1201 const char * lgrmi2_domainandname;
1204 struct LOCALGROUP_MEMBERS_INFO_3 {
1205 const char * lgrmi3_domainandname;
1208 struct LOCALGROUP_USERS_INFO_0 {
1209 const char * lgrui0_name;
1212 struct TIME_OF_DAY_INFO {
1213 uint32_t tod_elapsedt;
1214 uint32_t tod_msecs;
1215 uint32_t tod_hours;
1216 uint32_t tod_mins;
1217 uint32_t tod_secs;
1218 uint32_t tod_hunds;
1219 int32_t tod_timezone;
1220 uint32_t tod_tinterval;
1221 uint32_t tod_day;
1222 uint32_t tod_month;
1223 uint32_t tod_year;
1224 uint32_t tod_weekday;
1227 struct SHARE_INFO_0 {
1228 const char * shi0_netname;
1231 struct SHARE_INFO_1 {
1232 const char * shi1_netname;
1233 uint32_t shi1_type;
1234 const char * shi1_remark;
1237 struct SHARE_INFO_2 {
1238 const char * shi2_netname;
1239 uint32_t shi2_type;
1240 const char * shi2_remark;
1241 uint32_t shi2_permissions;
1242 uint32_t shi2_max_uses;
1243 uint32_t shi2_current_uses;
1244 const char * shi2_path;
1245 const char * shi2_passwd;
1248 struct SHARE_INFO_501 {
1249 const char * shi501_netname;
1250 uint32_t shi501_type;
1251 const char * shi501_remark;
1252 uint32_t shi501_flags;
1255 struct SHARE_INFO_502 {
1256 const char * shi502_netname;
1257 uint32_t shi502_type;
1258 const char * shi502_remark;
1259 uint32_t shi502_permissions;
1260 uint32_t shi502_max_uses;
1261 uint32_t shi502_current_uses;
1262 const char * shi502_path;
1263 const char * shi502_passwd;
1264 uint32_t shi502_reserved;
1265 struct security_descriptor * shi502_security_descriptor;
1268 struct SHARE_INFO_1004 {
1269 const char * shi1004_remark;
1272 struct SHARE_INFO_1005 {
1273 uint32_t shi1005_flags;
1276 struct SHARE_INFO_1006 {
1277 uint32_t shi1006_max_uses;
1280 struct FILE_INFO_2 {
1281 uint32_t fi2_id;
1284 struct FILE_INFO_3 {
1285 uint32_t fi3_id;
1286 uint32_t fi3_permissions;
1287 uint32_t fi3_num_locks;
1288 const char * fi3_pathname;
1289 const char * fi3_username;
1292 struct NETLOGON_INFO_1 {
1293 uint32_t netlog1_flags;
1294 NET_API_STATUS netlog1_pdc_connection_status;
1297 struct NETLOGON_INFO_2 {
1298 uint32_t netlog2_flags;
1299 NET_API_STATUS netlog2_pdc_connection_status;
1300 const char * netlog2_trusted_dc_name;
1301 NET_API_STATUS netlog2_tc_connection_status;
1304 struct NETLOGON_INFO_3 {
1305 uint32_t netlog1_flags;
1306 uint32_t netlog3_logon_attempts;
1307 uint32_t netlog3_reserved1;
1308 uint32_t netlog3_reserved2;
1309 uint32_t netlog3_reserved3;
1310 uint32_t netlog3_reserved4;
1311 uint32_t netlog3_reserved5;
1314 struct NETLOGON_INFO_4 {
1315 const char * netlog4_trusted_dc_name;
1316 const char * netlog4_trusted_domain_name;
1319 #define DS_PDC_FLAG ( 0x00000001 )
1320 #define DS_GC_FLAG ( 0x00000004 )
1321 #define DS_LDAP_FLAG ( 0x00000008 )
1322 #define DS_DS_FLAG ( 0x00000010 )
1323 #define DS_KDC_FLAG ( 0x00000020 )
1324 #define DS_TIMESERV_FLAG ( 0x00000040 )
1325 #define DS_CLOSEST_FLAG ( 0x00000080 )
1326 #define DS_WRITABLE_FLAG ( 0x00000100 )
1327 #define DS_GOOD_TIMESERV_FLAG ( 0x00000200 )
1328 #define DS_NDNC_FLAG ( 0x00000400 )
1329 #define DS_SELECT_SECRET_DOMAIN_6_FLAG ( 0x00000800 )
1330 #define DS_FULL_SECRET_DOMAIN_6_FLAG ( 0x00001000 )
1331 #define DS_WS_FLAG ( 0x00002000 )
1332 #define DS_DS_8_FLAG ( 0x00004000 )
1333 #define DS_DNS_CONTROLLER_FLAG ( 0x20000000 )
1334 #define DS_DNS_DOMAIN_FLAG ( 0x40000000 )
1335 #define DS_DNS_FOREST_FLAG ( 0x80000000 )
1337 #endif /* _HEADER_libnetapi */
1339 #ifndef _HEADER_netlogon
1341 #define NETLOGON_CONTROL_QUERY ( 0x00000001 )
1342 #define NETLOGON_CONTROL_REPLICATE ( 0x00000002 )
1343 #define NETLOGON_CONTROL_SYNCHRONIZE ( 0x00000003 )
1344 #define NETLOGON_CONTROL_PDC_REPLICATE ( 0x00000004 )
1345 #define NETLOGON_CONTROL_REDISCOVER ( 0x00000005 )
1346 #define NETLOGON_CONTROL_TC_QUERY ( 0x00000006 )
1347 #define NETLOGON_CONTROL_TRANSPORT_NOTIFY ( 0x00000007 )
1348 #define NETLOGON_CONTROL_FIND_USER ( 0x00000008 )
1349 #define NETLOGON_CONTROL_CHANGE_PASSWORD ( 0x00000009 )
1350 #define NETLOGON_CONTROL_TC_VERIFY ( 0x0000000A )
1351 #define NETLOGON_CONTROL_FORCE_DNS_REG ( 0x0000000B )
1352 #define NETLOGON_CONTROL_QUERY_DNS_REG ( 0x0000000C )
1353 #define NETLOGON_CONTROL_BACKUP_CHANGE_LOG ( 0x0000FFFC )
1354 #define NETLOGON_CONTROL_TRUNCATE_LOG ( 0x0000FFFD )
1355 #define NETLOGON_CONTROL_SET_DBFLAG ( 0x0000FFFE )
1356 #define NETLOGON_CONTROL_BREAKPOINT ( 0x0000FFFF )
1358 #define DS_FORCE_REDISCOVERY ( 0x00000001 )
1359 #define DS_DIRECTORY_SERVICE_REQUIRED ( 0x00000010 )
1360 #define DS_DIRECTORY_SERVICE_PREFERRED ( 0x00000020 )
1361 #define DS_GC_SERVER_REQUIRED ( 0x00000040 )
1362 #define DS_PDC_REQUIRED ( 0x00000080 )
1363 #define DS_BACKGROUND_ONLY ( 0x00000100 )
1364 #define DS_IP_REQUIRED ( 0x00000200 )
1365 #define DS_KDC_REQUIRED ( 0x00000400 )
1366 #define DS_TIMESERV_REQUIRED ( 0x00000800 )
1367 #define DS_WRITABLE_REQUIRED ( 0x00001000 )
1368 #define DS_GOOD_TIMESERV_PREFERRED ( 0x00002000 )
1369 #define DS_AVOID_SELF ( 0x00004000 )
1370 #define DS_ONLY_LDAP_NEEDED ( 0x00008000 )
1371 #define DS_IS_FLAT_NAME ( 0x00010000 )
1372 #define DS_IS_DNS_NAME ( 0x00020000 )
1373 #define DS_TRY_NEXTCLOSEST_SITE ( 0x00040000 )
1374 #define DS_DIRECTORY_SERVICE_6_REQUIRED ( 0x00080000 )
1375 #define DS_WEB_SERVICE_REQUIRED ( 0x00100000 )
1376 #define DS_RETURN_DNS_NAME ( 0x40000000 )
1377 #define DS_RETURN_FLAT_NAME ( 0x80000000 )
1379 #endif /* _HEADER_netlogon */
1381 /****************************************************************
1382 ****************************************************************/
1384 struct libnetapi_ctx;
1386 /****************************************************************
1387 ****************************************************************/
1389 NET_API_STATUS libnetapi_init(struct libnetapi_ctx **ctx);
1391 /****************************************************************
1392 ****************************************************************/
1394 NET_API_STATUS libnetapi_free(struct libnetapi_ctx *ctx);
1396 /****************************************************************
1397 ****************************************************************/
1399 NET_API_STATUS libnetapi_getctx(struct libnetapi_ctx **ctx);
1401 NET_API_STATUS libnetapi_get_username(struct libnetapi_ctx *ctx,
1402 const char **username);
1404 NET_API_STATUS libnetapi_get_password(struct libnetapi_ctx *ctx,
1405 const char **password);
1407 /****************************************************************
1408 ****************************************************************/
1410 NET_API_STATUS libnetapi_set_debuglevel(struct libnetapi_ctx *ctx,
1411 const char *debuglevel);
1413 /****************************************************************
1414 ****************************************************************/
1416 NET_API_STATUS libnetapi_set_creds(struct libnetapi_ctx *ctx,
1417 struct cli_credentials *creds);
1419 NET_API_STATUS libnetapi_get_creds(struct libnetapi_ctx *ctx,
1420 struct cli_credentials **creds);
1422 NET_API_STATUS libnetapi_set_username(struct libnetapi_ctx *ctx,
1423 const char *username);
1425 /****************************************************************
1426 ****************************************************************/
1428 NET_API_STATUS libnetapi_set_password(struct libnetapi_ctx *ctx,
1429 const char *password);
1431 /****************************************************************
1432 ****************************************************************/
1434 NET_API_STATUS libnetapi_set_workgroup(struct libnetapi_ctx *ctx,
1435 const char *workgroup);
1437 /****************************************************************
1438 ****************************************************************/
1440 NET_API_STATUS libnetapi_set_use_kerberos(struct libnetapi_ctx *ctx);
1442 /****************************************************************
1443 ****************************************************************/
1445 NET_API_STATUS libnetapi_get_use_kerberos(struct libnetapi_ctx *ctx,
1446 int *use_kerberos);
1448 /****************************************************************
1449 ****************************************************************/
1451 NET_API_STATUS libnetapi_set_logfile(struct libnetapi_ctx *ctx,
1452 const char *logfile);
1454 /****************************************************************
1455 ****************************************************************/
1457 NET_API_STATUS libnetapi_set_use_ccache(struct libnetapi_ctx *ctx);
1459 /****************************************************************
1460 Return a specific libnetapi error as a string, caller must free with NetApiBufferFree
1461 ****************************************************************/
1463 char *libnetapi_errstr(NET_API_STATUS status);
1465 /****************************************************************
1466 Return the last libnetapi error as a string, caller must free with NetApiBufferFree
1467 ctx is optional
1468 ****************************************************************/
1470 char *libnetapi_get_error_string(struct libnetapi_ctx *ctx,
1471 NET_API_STATUS status);
1473 /****************************************************************
1474 NetApiBufferAllocate
1475 ****************************************************************/
1477 NET_API_STATUS NetApiBufferAllocate(uint32_t byte_count,
1478 void **buffer);
1480 /****************************************************************
1481 NetApiBufferFree
1482 ****************************************************************/
1484 NET_API_STATUS NetApiBufferFree(void *buffer);
1486 /************************************************************//**
1488 * ConvertSidToStringSid
1490 * @brief Convert a domain sid into a string
1492 * @param[in] sid A pointer to a sid structure
1493 * @param[in,out] sid_string A pointer that holds a pointer to a sid string. Caller
1494 * needs to free with free(3)
1495 * @return bool
1496 ***************************************************************/
1498 int ConvertSidToStringSid(const struct domsid *sid,
1499 char **sid_string);
1501 /************************************************************//**
1503 * ConvertStringSidToSid
1505 * @brief Convert a string into a domain sid
1507 * @param[in] sid_string A pointer to a sid string.
1508 * @param[in,out] sid A pointer that holds a pointer to a sid structure.
1509 * Caller needs to free with free(3)
1510 * @return bool
1511 ***************************************************************/
1513 int ConvertStringSidToSid(const char *sid_string,
1514 struct domsid **sid);
1516 /************************************************************//**
1518 * NetJoinDomain
1520 * @brief Join a computer to a domain or workgroup
1522 * @param[in] server The server name to connect to
1523 * @param[in] domain The domain or workgroup to join
1524 * @param[in] account_ou The organizational Unit to create the computer account
1525 * in (AD only)
1526 * @param[in] account The domain account used for joining a domain
1527 * @param[in] password The domain account's password used for joining a domain
1528 * @param[in] join_flags Bitmask field to define specific join features
1529 * @return NET_API_STATUS
1531 * example netdomjoin/netdomjoin.c
1532 ***************************************************************/
1534 NET_API_STATUS NetJoinDomain(const char * server /* [in] */,
1535 const char * domain /* [in] [ref] */,
1536 const char * account_ou /* [in] */,
1537 const char * account /* [in] */,
1538 const char * password /* [in] */,
1539 uint32_t join_flags /* [in] */);
1541 /************************************************************//**
1543 * NetUnjoinDomain
1545 * @brief Unjoin a computer from a domain or workgroup
1547 * @param[in] server_name The server name to connect to
1548 * @param[in] account The domain account used for unjoining a domain
1549 * @param[in] password The domain account's password used for unjoining a domain
1550 * @param[in] unjoin_flags Bitmask field to define specific unjoin features
1551 * @return NET_API_STATUS
1553 ***************************************************************/
1555 NET_API_STATUS NetUnjoinDomain(const char * server_name /* [in] */,
1556 const char * account /* [in] */,
1557 const char * password /* [in] */,
1558 uint32_t unjoin_flags /* [in] */);
1560 /************************************************************//**
1562 * NetGetJoinInformation
1564 * @brief Unjoin a computer from a domain or workgroup
1566 * @param[in] server_name The server name to connect to
1567 * @param[out] name_buffer Returns the name of the workgroup or domain
1568 * @param[out] name_type Returns the type of that name
1569 * @return NET_API_STATUS
1571 * example netdomjoin-gui/netdomjoin-gui.c
1573 ***************************************************************/
1575 NET_API_STATUS NetGetJoinInformation(const char * server_name /* [in] */,
1576 const char * *name_buffer /* [out] [ref] */,
1577 uint16_t *name_type /* [out] [ref] */);
1579 /************************************************************//**
1581 * NetGetJoinableOUs
1583 * @brief Query for the list of joinable organizational Units that can be used
1584 * for joining AD
1586 * @param[in] server_name The server name to connect to
1587 * @param[in] domain The AD domain to query
1588 * @param[in] account The domain account used for the query
1589 * @param[in] password The domain account's password used for the query
1590 * @param[out] ou_count The number of ous returned
1591 * @param[out] ous Returned string array containing the ous
1592 * @return NET_API_STATUS
1594 * example netdomjoin-gui/netdomjoin-gui.c
1596 ***************************************************************/
1598 NET_API_STATUS NetGetJoinableOUs(const char * server_name /* [in] */,
1599 const char * domain /* [in] [ref] */,
1600 const char * account /* [in] */,
1601 const char * password /* [in] */,
1602 uint32_t *ou_count /* [out] [ref] */,
1603 const char * **ous /* [out] [ref] */);
1605 /************************************************************//**
1607 * NetRenameMachineInDomain
1609 * @brief Rename a machine in a domain
1611 * @param[in] server_name The server name to connect to
1612 * @param[in] new_machine_name The new machine name
1613 * @param[in] account The domain account used for the query
1614 * @param[in] password The domain account's password used for the query
1615 * @param[in] rename_options Options used for the rename operation
1616 * @return NET_API_STATUS
1618 * example join/rename_machine.c
1620 ***************************************************************/
1622 NET_API_STATUS NetRenameMachineInDomain(const char * server_name /* [in] */,
1623 const char * new_machine_name /* [in] */,
1624 const char * account /* [in] */,
1625 const char * password /* [in] */,
1626 uint32_t rename_options /* [in] */);
1628 /************************************************************//**
1630 * NetProvisionComputerAccount
1632 * @brief Provision a machine for offline join
1634 * @param[in] domain The domain to provision for
1635 * @param[in] machine_name The machine account name
1636 * @param[in] machine_account_ou The machine account ou to create the account in
1637 * @param[in] dcname A specific domain controller to use for account creation
1638 * @param[in] options The options used for account creation
1639 * @param[in,out] provision_bin_data The generated binary buffer
1640 * @param[in,out] provision_bin_data_size The generated binary buffer size
1641 * @param[in,out] provision_text_data The generated text data blob
1642 * @return NET_API_STATUS
1644 * example join/provision_computer_account.c
1646 ***************************************************************/
1648 NET_API_STATUS NetProvisionComputerAccount(const char * domain /* [in] [ref] */,
1649 const char * machine_name /* [in] [ref] */,
1650 const char * machine_account_ou /* [in] [unique] */,
1651 const char * dcname /* [in] [unique] */,
1652 uint32_t options /* [in] */,
1653 uint8_t **provision_bin_data /* [in,out] [unique] */,
1654 uint32_t *provision_bin_data_size /* [in,out] [unique] */,
1655 const char * *provision_text_data /* [in,out] [unique] */);
1657 /************************************************************//**
1659 * NetRequestOfflineDomainJoin
1661 * @brief Request an offline domain join
1663 * @param[in] provision_bin_data The provided binary buffer
1664 * @param[in] provision_bin_data_size The provided binary buffer size
1665 * @param[in] options The options used for account creation
1666 * @param[in] windows_path The path for the joined image
1667 * @return NET_API_STATUS
1669 * example join/request_offline_domain_join.c
1671 ***************************************************************/
1673 NET_API_STATUS NetRequestOfflineDomainJoin(uint8_t *provision_bin_data /* [in] [unique] */,
1674 uint32_t provision_bin_data_size /* [in] */,
1675 uint32_t options /* [in] */,
1676 const char * windows_path /* [in] [unique] */);
1678 /************************************************************//**
1680 * NetComposeOfflineDomainJoin
1682 * @brief Compose an offline domain join blob
1684 * Intended to be used by external applications who provision the computer
1685 * acconut on their own.
1688 * @param[in] dns_domain_name The domain DNS name
1689 * @param[in] netbios_domain_name The domain NETBIOS name
1690 * @param[in] domain_sid The domain SID
1691 * @param[in] domain_guid The domain GUID
1692 * @param[in] forest_name The forest name
1693 * @param[in] machine_account_name The machine account name
1694 * @param[in] machine_account_password The machine account password
1695 * @param[in] dc_name The domain controller name used to provision the account
1696 * @param[in] dc_address The domain controller address used to provision the account
1697 * @param[in] domain_is_ad True if the domain is AD
1698 * @param[in,out] compose_bin_data The generated binary buffer
1699 * @param[in,out] compose_bin_data_size The generated binary buffer size
1700 * @param[in,out] compose_text_data The generated text data blob
1701 * @return NET_API_STATUS
1703 * example join/compose_offline_domain_join.c
1705 ***************************************************************/
1707 NET_API_STATUS NetComposeOfflineDomainJoin(const char *dns_domain_name /* [in] [ref] */,
1708 const char *netbios_domain_name /* [in] [ref] */,
1709 struct domsid *domain_sid /* [in] [ref] */,
1710 struct GUID *domain_guid /* [in] [ref] */,
1711 const char *forest_name /* [in] [ref] */,
1712 const char *machine_account_name /* [in] [ref] */,
1713 const char *machine_account_password /* [in] [ref] */,
1714 const char *dc_name /* [in] [unique] */,
1715 const char *dc_address /* [in] [unique] */,
1716 int domain_is_ad /* [in] */,
1717 uint8_t **provision_bin_data /* [in,out] [unique] */,
1718 uint32_t *provision_bin_data_size /* [in,out] [unique] */,
1719 const char * *provision_text_data /* [in,out] [unique] */);
1721 /************************************************************//**
1723 * NetServerGetInfo
1725 * @brief Get Information on a server
1727 * @param[in] server_name The server name to connect to
1728 * @param[in] level The level to define which information is requested
1729 * @param[out] buffer The returned buffer carrying the SERVER_INFO structure
1730 * @return NET_API_STATUS
1732 ***************************************************************/
1734 NET_API_STATUS NetServerGetInfo(const char * server_name /* [in] */,
1735 uint32_t level /* [in] */,
1736 uint8_t **buffer /* [out] [ref] */);
1738 /************************************************************//**
1740 * NetServerSetInfo
1742 * @brief Get Information on a server
1744 * @param[in] server_name The server name to connect to
1745 * @param[in] level The level to define which information is set
1746 * @param[in] buffer The buffer carrying the SERVER_INFO structure
1747 * @param[out] parm_error On failure returns the invalid SERVER_INFO member
1748 * @return NET_API_STATUS
1750 ***************************************************************/
1752 NET_API_STATUS NetServerSetInfo(const char * server_name /* [in] */,
1753 uint32_t level /* [in] */,
1754 uint8_t *buffer /* [in] [ref] */,
1755 uint32_t *parm_error /* [out] [ref] */);
1757 /************************************************************//**
1759 * NetWkstaGetInfo
1761 * @brief Get Information on a workstation
1763 * @param[in] wksta_name The workstation name to connect to
1764 * @param[in] level The level to define which information is requested
1765 * @param[out] buffer The returned buffer carrying the WKSTA_INFO structure
1766 * @return NET_API_STATUS
1768 ***************************************************************/
1770 NET_API_STATUS NetWkstaGetInfo(const char * wksta_name /* [in] */,
1771 uint32_t level /* [in] */,
1772 uint8_t **buffer /* [out] [ref] */);
1774 /************************************************************//**
1776 * NetGetDCName
1778 * @brief Query for the PDC for a given domain
1780 * @param[in] server_name The server name to connect to
1781 * @param[in] domain_name The name of the domain to lookup
1782 * @param[out] buffer The name of the domain to lookup
1783 * @return NET_API_STATUS
1785 * example getdc/getdc.c
1786 ***************************************************************/
1788 NET_API_STATUS NetGetDCName(const char * server_name /* [in] */,
1789 const char * domain_name /* [in] */,
1790 uint8_t **buffer /* [out] [ref] */);
1792 /************************************************************//**
1794 * NetGetAnyDCName
1796 * @brief Query for any DC for a given domain
1798 * @param[in] server_name The server name to connect to
1799 * @param[in] domain_name The name of the domain to lookup
1800 * @param[out] buffer The name of the domain to lookup
1801 * @return NET_API_STATUS
1803 * example getdc/getdc.c
1804 ***************************************************************/
1806 NET_API_STATUS NetGetAnyDCName(const char * server_name /* [in] */,
1807 const char * domain_name /* [in] */,
1808 uint8_t **buffer /* [out] [ref] */);
1811 /************************************************************//**
1813 * DsGetDcName
1815 * @brief Lookup a DC for a given domain and return information structure
1817 * @param[in] server_name The server name to connect to
1818 * @param[in] domain_name The name of the domain to lookup (cannot be NULL)
1819 * @param[in] domain_guid The GUID of the domain to lookup (optional)
1820 * @param[in] site_name The name of the site the DC should reside in
1821 * @param[in] flags A bitmask to request specific features supported by the DC
1822 * @param[out] dc_info Pointer to a DOMAIN_CONTROLLER_INFO structure
1823 * @return NET_API_STATUS
1825 * example dsgetdc/dsgetdc.c
1826 ***************************************************************/
1828 NET_API_STATUS DsGetDcName(const char * server_name /* [in] [unique] */,
1829 const char * domain_name /* [in] [ref] */,
1830 struct GUID *domain_guid /* [in] [unique] */,
1831 const char * site_name /* [in] [unique] */,
1832 uint32_t flags /* [in] */,
1833 struct DOMAIN_CONTROLLER_INFO **dc_info /* [out] [ref] */);
1835 /************************************************************//**
1837 * NetUserAdd
1839 * @brief Create a user on a given server
1841 * @param[in] server_name The server name to connect to
1842 * @param[in] level The level of the USER_INFO structure passed in (Currently
1843 * only level 1 is supported)
1844 * @param[in] buffer The buffer carrying the USER_INFO structure
1845 * @param[out] parm_error In case of error returns the failing member of the
1846 * structure
1847 * @return NET_API_STATUS
1849 * example user/user_add.c
1850 ***************************************************************/
1852 NET_API_STATUS NetUserAdd(const char * server_name /* [in] */,
1853 uint32_t level /* [in] */,
1854 uint8_t *buffer /* [in] [ref] */,
1855 uint32_t *parm_error /* [out] [ref] */);
1857 /************************************************************//**
1859 * NetUserDel
1861 * @brief Delete a user on a given server
1863 * @param[in] server_name The server name to connect to
1864 * @param[in] user_name The user account to delete
1865 * @return NET_API_STATUS
1867 * example user/user_del.c
1868 ***************************************************************/
1870 NET_API_STATUS NetUserDel(const char * server_name /* [in] */,
1871 const char * user_name /* [in] */);
1873 /************************************************************//**
1875 * NetUserEnum
1877 * @brief Enumerate accounts on a server
1879 * @param[in] server_name The server name to connect to
1880 * @param[in] level The enumeration level used for the query (Currently only
1881 * level 0 is supported)
1882 * @param[in] filter The account flags filter used for the query
1883 * @param[out] buffer The returned enumeration buffer
1884 * @param[in] prefmaxlen The requested maximal buffer size
1885 * @param[out] entries_read The number of returned entries
1886 * @param[out] total_entries The number of total entries
1887 * @param[in,out] resume_handle A handle passed in and returned for resuming
1888 * operations
1889 * @return NET_API_STATUS
1891 * example user/user_enum.c
1892 ***************************************************************/
1894 NET_API_STATUS NetUserEnum(const char * server_name /* [in] */,
1895 uint32_t level /* [in] */,
1896 uint32_t filter /* [in] */,
1897 uint8_t **buffer /* [out] [ref] */,
1898 uint32_t prefmaxlen /* [in] */,
1899 uint32_t *entries_read /* [out] [ref] */,
1900 uint32_t *total_entries /* [out] [ref] */,
1901 uint32_t *resume_handle /* [in,out] [ref] */);
1903 /************************************************************//**
1905 * NetUserChangePassword
1907 * @brief Change the password for a user on a given server or in a given domain
1909 * @param[in] domain_name The server or domain name to connect to
1910 * @param[in] user_name The user account to change the password for
1911 * @param[in] old_password The user account's old password
1912 * @param[in] new_password The user account's new password
1913 * @return NET_API_STATUS
1915 * example user/user_chgpwd.c
1916 ***************************************************************/
1918 NET_API_STATUS NetUserChangePassword(const char * domain_name /* [in] */,
1919 const char * user_name /* [in] */,
1920 const char * old_password /* [in] */,
1921 const char * new_password /* [in] */);
1923 /************************************************************//**
1925 * NetUserGetInfo
1927 * @brief Get User Information
1929 * @param[in] server_name The server name to connect to
1930 * @param[in] user_name The name of the user that is going to be queried
1931 * @param[in] level The level defining the requested USER_INFO_X structure
1932 * @param[out] buffer The buffer containing a USER_INFO_X structure
1933 * @return NET_API_STATUS
1935 * example user/user_getinfo.c
1936 ***************************************************************/
1938 NET_API_STATUS NetUserGetInfo(const char * server_name /* [in] */,
1939 const char * user_name /* [in] */,
1940 uint32_t level /* [in] */,
1941 uint8_t **buffer /* [out] [ref] */);
1943 /************************************************************//**
1945 * NetUserSetInfo
1947 * @brief Set User Information
1949 * @param[in] server_name The server name to connect to
1950 * @param[in] user_name The name of the user that is going to be modified
1951 * @param[in] level The level defining the requested USER_INFO_X structure
1952 * @param[in] buffer The buffer containing a USER_INFO_X structure
1953 * @param[out] parm_err The returned parameter error number if any
1954 * @return NET_API_STATUS
1956 * example user/user_setinfo.c
1957 ***************************************************************/
1959 NET_API_STATUS NetUserSetInfo(const char * server_name /* [in] */,
1960 const char * user_name /* [in] */,
1961 uint32_t level /* [in] */,
1962 uint8_t *buffer /* [in] [ref] */,
1963 uint32_t *parm_err /* [out] [ref] */);
1965 /************************************************************//**
1967 * NetUserModalsGet
1969 * @brief Get SAM domain and password information
1971 * @param[in] server_name The server name to connect to
1972 * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1973 * @param[out] buffer The returned USER_MODALS_INFO_X buffer
1974 * @return NET_API_STATUS
1976 * example user/user_modalsget.c
1977 ***************************************************************/
1979 NET_API_STATUS NetUserModalsGet(const char * server_name /* [in] */,
1980 uint32_t level /* [in] */,
1981 uint8_t **buffer /* [out] [ref] */);
1983 /************************************************************//**
1985 * NetUserModalsSet
1987 * @brief Set SAM domain and password information
1989 * @param[in] server_name The server name to connect to
1990 * @param[in] level The level defining which USER_MODALS_INFO_X buffer to query
1991 * @param[out] buffer The buffer conntaing a USER_MODALS_INFO_X structure
1992 * @param[out] parm_err The returned parameter error number if any
1993 * @return NET_API_STATUS
1995 * example user/user_modalsset.c
1996 ***************************************************************/
1998 NET_API_STATUS NetUserModalsSet(const char * server_name /* [in] */,
1999 uint32_t level /* [in] */,
2000 uint8_t *buffer /* [in] [ref] */,
2001 uint32_t *parm_err /* [out] [ref] */);
2003 /************************************************************//**
2005 * NetUserGetGroups
2007 * @brief Enumerate grouplist of a user on a server
2009 * @param[in] server_name The server name to connect to
2010 * @param[in] user_name The user name to query
2011 * @param[in] level The enumeration level used for the query (Currently only
2012 * level 0 is supported)
2013 * @param[out] buffer The returned enumeration buffer
2014 * @param[in] prefmaxlen The requested maximal buffer size
2015 * @param[out] entries_read The number of returned entries
2016 * @param[out] total_entries The number of total entries
2017 * @return NET_API_STATUS
2019 * example user/user_getgroups.c
2020 ***************************************************************/
2022 NET_API_STATUS NetUserGetGroups(const char * server_name /* [in] */,
2023 const char * user_name /* [in] */,
2024 uint32_t level /* [in] */,
2025 uint8_t **buffer /* [out] [ref] */,
2026 uint32_t prefmaxlen /* [in] */,
2027 uint32_t *entries_read /* [out] [ref] */,
2028 uint32_t *total_entries /* [out] [ref] */);
2030 /************************************************************//**
2032 * NetUserSetGroups
2034 * @brief Set grouplist of a user on a server
2036 * @param[in] server_name The server name to connect to
2037 * @param[in] user_name The user name to query
2038 * @param[in] level The level defining the GROUP_USERS_INFO_X structures in the buffer
2039 * @param[in] buffer The buffer containing GROUP_USERS_INFO_X structures
2040 * @param[in] num_entries The number of X structures in the buffer
2041 * @return NET_API_STATUS
2043 * example user/user_setgroups.c
2044 ***************************************************************/
2046 NET_API_STATUS NetUserSetGroups(const char * server_name /* [in] */,
2047 const char * user_name /* [in] */,
2048 uint32_t level /* [in] */,
2049 uint8_t *buffer /* [in] [ref] */,
2050 uint32_t num_entries /* [in] */);
2052 /************************************************************//**
2054 * NetUserGetLocalGroups
2056 * @brief Enumerate local grouplist of a user on a server
2058 * @param[in] server_name The server name to connect to
2059 * @param[in] user_name The user name to query
2060 * @param[in] level The enumeration level used for the query
2061 * @param[in] flags The flags used for the query
2062 * @param[out] buffer The returned enumeration buffer
2063 * @param[in] prefmaxlen The requested maximal buffer size
2064 * @param[out] entries_read The number of returned entries
2065 * @param[out] total_entries The number of total entries
2066 * @return NET_API_STATUS
2068 * example user/user_getlocalgroups.c
2069 ***************************************************************/
2071 NET_API_STATUS NetUserGetLocalGroups(const char * server_name /* [in] */,
2072 const char * user_name /* [in] */,
2073 uint32_t level /* [in] */,
2074 uint32_t flags /* [in] */,
2075 uint8_t **buffer /* [out] [ref] */,
2076 uint32_t prefmaxlen /* [in] */,
2077 uint32_t *entries_read /* [out] [ref] */,
2078 uint32_t *total_entries /* [out] [ref] */);
2080 /************************************************************//**
2082 * NetQueryDisplayInformation
2084 * @brief Enumerate accounts on a server
2086 * @param[in] server_name The server name to connect to
2087 * @param[in] level The enumeration level used for the query
2088 * @param[in] idx The index to start the display enumeration at
2089 * @param[in] entries_requested The number of entries requested
2090 * @param[in] prefmaxlen The requested maximal buffer size
2091 * @param[out] entries_read The number of returned entries
2092 * @param[out] buffer The returned display information buffer
2093 * @return NET_API_STATUS
2095 * example user/user_dispinfo.c
2096 ***************************************************************/
2098 NET_API_STATUS NetQueryDisplayInformation(const char * server_name /* [in] [unique] */,
2099 uint32_t level /* [in] */,
2100 uint32_t idx /* [in] */,
2101 uint32_t entries_requested /* [in] */,
2102 uint32_t prefmaxlen /* [in] */,
2103 uint32_t *entries_read /* [out] [ref] */,
2104 void **buffer /* [out] [noprint,ref] */);
2106 /************************************************************//**
2108 * NetGroupAdd
2110 * @brief Create Domain Group
2112 * @param[in] server_name The server name to connect to
2113 * @param[in] level The level used for the new group creation
2114 * @param[in] buf The buffer containing the group structure
2115 * @param[out] parm_err The returned parameter error number if any
2116 * @return NET_API_STATUS
2118 * example group/group_add.c
2119 ***************************************************************/
2121 NET_API_STATUS NetGroupAdd(const char * server_name /* [in] */,
2122 uint32_t level /* [in] */,
2123 uint8_t *buf /* [in] [ref] */,
2124 uint32_t *parm_err /* [out] [ref] */);
2126 /************************************************************//**
2128 * NetGroupDel
2130 * @brief Delete Domain Group
2132 * @param[in] server_name The server name to connect to
2133 * @param[in] group_name The name of the group that is going to be deleted
2134 * @return NET_API_STATUS
2136 * example group/group_del.c
2137 ***************************************************************/
2139 NET_API_STATUS NetGroupDel(const char * server_name /* [in] */,
2140 const char * group_name /* [in] */);
2142 /************************************************************//**
2144 * NetGroupEnum
2146 * @brief Enumerate groups on a server
2148 * @param[in] server_name The server name to connect to
2149 * @param[in] level The enumeration level used for the query (Currently only
2150 * level 0 is supported)
2151 * @param[out] buffer The returned enumeration buffer
2152 * @param[in] prefmaxlen The requested maximal buffer size
2153 * @param[out] entries_read The number of returned entries
2154 * @param[out] total_entries The number of total entries
2155 * @param[in,out] resume_handle A handle passed in and returned for resuming
2156 * operations
2157 * @return NET_API_STATUS
2159 * example group/group_enum.c
2160 ***************************************************************/
2162 NET_API_STATUS NetGroupEnum(const char * server_name /* [in] */,
2163 uint32_t level /* [in] */,
2164 uint8_t **buffer /* [out] [ref] */,
2165 uint32_t prefmaxlen /* [in] */,
2166 uint32_t *entries_read /* [out] [ref] */,
2167 uint32_t *total_entries /* [out] [ref] */,
2168 uint32_t *resume_handle /* [in,out] [ref] */);
2170 /************************************************************//**
2172 * NetGroupSetInfo
2174 * @brief Set Domain Group Information
2176 * @param[in] server_name The server name to connect to
2177 * @param[in] group_name The name of the group that is going to be modified
2178 * @param[in] level The level defining the structure type in buf
2179 * @param[in] buf The buffer containing a GROUP_INFO_X structure
2180 * @param[out] parm_err The returned parameter error number if any
2181 * @return NET_API_STATUS
2183 * example group/group_setinfo.c
2184 ***************************************************************/
2186 NET_API_STATUS NetGroupSetInfo(const char * server_name /* [in] */,
2187 const char * group_name /* [in] */,
2188 uint32_t level /* [in] */,
2189 uint8_t *buf /* [in] [ref] */,
2190 uint32_t *parm_err /* [out] [ref] */);
2192 /************************************************************//**
2194 * NetGroupGetInfo
2196 * @brief Get Domain Group Information
2198 * @param[in] server_name The server name to connect to
2199 * @param[in] group_name The name of the group that is going to be queried
2200 * @param[in] level The level defining the requested GROUP_INFO_X structure
2201 * @param[out] buf The buffer containing a GROUP_INFO_X structure
2202 * @return NET_API_STATUS
2204 * example group/group_getinfo.c
2205 ***************************************************************/
2207 NET_API_STATUS NetGroupGetInfo(const char * server_name /* [in] */,
2208 const char * group_name /* [in] */,
2209 uint32_t level /* [in] */,
2210 uint8_t **buf /* [out] [ref] */);
2212 /************************************************************//**
2214 * NetGroupAddUser
2216 * @brief Add existing User to existing Domain Group
2218 * @param[in] server_name The server name to connect to
2219 * @param[in] group_name The name of the group that is going to be modified
2220 * @param[in] user_name The name of the user that is going to be added to the
2221 * group
2222 * @return NET_API_STATUS
2224 * example group/group_adduser.c
2225 ***************************************************************/
2227 NET_API_STATUS NetGroupAddUser(const char * server_name /* [in] */,
2228 const char * group_name /* [in] */,
2229 const char * user_name /* [in] */);
2231 /************************************************************//**
2233 * NetGroupDelUser
2235 * @brief Remove User from Domain Group
2237 * @param[in] server_name The server name to connect to
2238 * @param[in] group_name The name of the group that is going to be modified
2239 * @param[in] user_name The name of the user that is going to be removed from
2240 * the group
2241 * @return NET_API_STATUS
2243 * example group/group_deluser.c
2244 ***************************************************************/
2246 NET_API_STATUS NetGroupDelUser(const char * server_name /* [in] */,
2247 const char * group_name /* [in] */,
2248 const char * user_name /* [in] */);
2250 /************************************************************//**
2252 * NetGroupGetUsers
2254 * @brief Get Users for a group on a server
2256 * @param[in] server_name The server name to connect to
2257 * @param[in] group_name The group name to enumerate users for
2258 * @param[in] level The enumeration level used for the query
2259 * @param[out] buffer The returned enumeration buffer
2260 * @param[in] prefmaxlen The requested maximal buffer size
2261 * @param[out] entries_read The number of returned entries
2262 * @param[out] total_entries The number of total entries
2263 * @param[in,out] resume_handle A handle passed in and returned for resuming
2264 * operations
2265 * @return NET_API_STATUS
2267 * example group/group_getusers.c
2268 ***************************************************************/
2270 NET_API_STATUS NetGroupGetUsers(const char * server_name /* [in] */,
2271 const char * group_name /* [in] */,
2272 uint32_t level /* [in] */,
2273 uint8_t **buffer /* [out] [ref] */,
2274 uint32_t prefmaxlen /* [in] */,
2275 uint32_t *entries_read /* [out] [ref] */,
2276 uint32_t *total_entries /* [out] [ref] */,
2277 uint32_t *resume_handle /* [in,out] [ref] */);
2279 /************************************************************//**
2281 * NetGroupSetUsers
2283 * @brief Set Users for a group on a server
2285 * @param[in] server_name The server name to connect to
2286 * @param[in] group_name The group name to enumerate users for
2287 * @param[in] level The enumeration level used for the query
2288 * @param[in] buffer The buffer containing a X structure
2289 * @param[in] num_entries The number of X entries in the buffer
2290 * @return NET_API_STATUS
2292 * example group/group_setusers.c
2293 ***************************************************************/
2295 NET_API_STATUS NetGroupSetUsers(const char * server_name /* [in] */,
2296 const char * group_name /* [in] */,
2297 uint32_t level /* [in] */,
2298 uint8_t *buffer /* [in] [ref] */,
2299 uint32_t num_entries /* [in] */);
2301 /************************************************************//**
2303 * NetLocalGroupAdd
2305 * @brief Create Local Group
2307 * @param[in] server_name The server name to connect to
2308 * @param[in] level The level used for the new group creation
2309 * @param[in] buf The buffer containing the group structure
2310 * @param[out] parm_err The returned parameter error number if any
2311 * @return NET_API_STATUS
2313 * example localgroup/localgroup_add.c
2314 ***************************************************************/
2316 NET_API_STATUS NetLocalGroupAdd(const char * server_name /* [in] */,
2317 uint32_t level /* [in] */,
2318 uint8_t *buf /* [in] [ref] */,
2319 uint32_t *parm_err /* [out] [ref] */);
2321 /************************************************************//**
2323 * NetLocalGroupDel
2325 * @brief Delete Local Group
2327 * @param[in] server_name The server name to connect to
2328 * @param[in] group_name The name of the group that is going to be deleted
2329 * @return NET_API_STATUS
2331 * example localgroup/localgroup_del.c
2332 ***************************************************************/
2335 NET_API_STATUS NetLocalGroupDel(const char * server_name /* [in] */,
2336 const char * group_name /* [in] */);
2338 /************************************************************//**
2340 * NetLocalGroupGetInfo
2342 * @brief Get Local Group Information
2344 * @param[in] server_name The server name to connect to
2345 * @param[in] group_name The name of the group that is going to be queried
2346 * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2347 * @param[out] buf The buffer containing a LOCALGROUP_INFO_X structure
2348 * @return NET_API_STATUS
2350 * example localgroup/localgroup_getinfo.c
2351 ***************************************************************/
2353 NET_API_STATUS NetLocalGroupGetInfo(const char * server_name /* [in] */,
2354 const char * group_name /* [in] */,
2355 uint32_t level /* [in] */,
2356 uint8_t **buf /* [out] [ref] */);
2358 /************************************************************//**
2360 * NetLocalGroupSetInfo
2362 * @brief Set Local Group Information
2364 * @param[in] server_name The server name to connect to
2365 * @param[in] group_name The name of the group that is going to be modified
2366 * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
2367 * @param[in] buf The buffer containing a LOCALGROUP_INFO_X structure
2368 * @param[out] parm_err The returned parameter error number if any
2369 * @return NET_API_STATUS
2371 * example localgroup/localgroup_setinfo.c
2372 ***************************************************************/
2375 NET_API_STATUS NetLocalGroupSetInfo(const char * server_name /* [in] */,
2376 const char * group_name /* [in] */,
2377 uint32_t level /* [in] */,
2378 uint8_t *buf /* [in] [ref] */,
2379 uint32_t *parm_err /* [out] [ref] */);
2381 /************************************************************//**
2383 * NetLocalGroupEnum
2385 * @brief Enumerate local groups on a server
2387 * @param[in] server_name The server name to connect to
2388 * @param[in] level The enumeration level used for the query (Currently only
2389 * level 0 is supported)
2390 * @param[out] buffer The returned enumeration buffer
2391 * @param[in] prefmaxlen The requested maximal buffer size
2392 * @param[out] entries_read The number of returned entries
2393 * @param[out] total_entries The number of total entries
2394 * @param[in,out] resume_handle A handle passed in and returned for resuming
2395 * operations
2396 * @return NET_API_STATUS
2398 * example localgroup/localgroup_enum.c
2399 ***************************************************************/
2401 NET_API_STATUS NetLocalGroupEnum(const char * server_name /* [in] */,
2402 uint32_t level /* [in] */,
2403 uint8_t **buffer /* [out] [ref] */,
2404 uint32_t prefmaxlen /* [in] */,
2405 uint32_t *entries_read /* [out] [ref] */,
2406 uint32_t *total_entries /* [out] [ref] */,
2407 uint32_t *resume_handle /* [in,out] [ref] */);
2409 /************************************************************//**
2411 * NetLocalGroupAddMembers
2413 * @brief Add Members to a Local Group
2415 * @param[in] server_name The server name to connect to
2416 * @param[in] group_name The name of the group that is going to modified
2417 * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2418 * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2419 * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2420 * the buffer
2421 * @return NET_API_STATUS
2423 * example localgroup/localgroup_addmembers.c
2424 ***************************************************************/
2426 NET_API_STATUS NetLocalGroupAddMembers(const char * server_name /* [in] */,
2427 const char * group_name /* [in] */,
2428 uint32_t level /* [in] */,
2429 uint8_t *buffer /* [in] [ref] */,
2430 uint32_t total_entries /* [in] */);
2432 /************************************************************//**
2434 * NetLocalGroupDelMembers
2436 * @brief Delete Members from a Local Group
2438 * @param[in] server_name The server name to connect to
2439 * @param[in] group_name The name of the group that is going to modified
2440 * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2441 * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2442 * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2443 * the buffer
2444 * @return NET_API_STATUS
2446 * example localgroup/localgroup_delmembers.c
2447 ***************************************************************/
2449 NET_API_STATUS NetLocalGroupDelMembers(const char * server_name /* [in] */,
2450 const char * group_name /* [in] */,
2451 uint32_t level /* [in] */,
2452 uint8_t *buffer /* [in] [ref] */,
2453 uint32_t total_entries /* [in] */);
2455 /************************************************************//**
2457 * NetLocalGroupGetMembers
2459 * @brief Enumerate Members in a local group
2461 * @param[in] server_name The server name to connect to
2462 * @param[in] local_group_name The localgroup that is going to be queried
2463 * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2464 * @param[out] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X
2465 * structure
2466 * @param[in] prefmaxlen The requested maximal buffer size
2467 * @param[out] entries_read The number of LOCALGROUP_MEMBERS_INFO_X entries in the buffer
2468 * @param[out] total_entries The total number of LOCALGROUP_MEMBERS_INFO_X entries for that group
2469 * @param[in,out] resume_handle A handle passed in and returned for resuming
2470 * operations
2471 * @return NET_API_STATUS
2473 * example localgroup/localgroup_getmembers.c
2474 ***************************************************************/
2476 NET_API_STATUS NetLocalGroupGetMembers(const char * server_name /* [in] */,
2477 const char * local_group_name /* [in] */,
2478 uint32_t level /* [in] */,
2479 uint8_t **buffer /* [out] [ref] */,
2480 uint32_t prefmaxlen /* [in] */,
2481 uint32_t *entries_read /* [out] [ref] */,
2482 uint32_t *total_entries /* [out] [ref] */,
2483 uint32_t *resume_handle /* [in,out] [ref] */);
2485 /************************************************************//**
2487 * NetLocalGroupSetMembers
2489 * @brief Set Members in a Local Group
2491 * @param[in] server_name The server name to connect to
2492 * @param[in] group_name The name of the group that is going to modified
2493 * @param[in] level The level defining the LOCALGROUP_MEMBERS_INFO_X structure
2494 * @param[in] buffer The buffer containing a LOCALGROUP_MEMBERS_INFO_X structure
2495 * @param[in] total_entries The number of LOCALGROUP_MEMBERS_INFO_X entries in
2496 * the buffer
2497 * @return NET_API_STATUS
2499 * example localgroup/localgroup_setmembers.c
2500 ***************************************************************/
2502 NET_API_STATUS NetLocalGroupSetMembers(const char * server_name /* [in] */,
2503 const char * group_name /* [in] */,
2504 uint32_t level /* [in] */,
2505 uint8_t *buffer /* [in] [ref] */,
2506 uint32_t total_entries /* [in] */);
2508 /************************************************************//**
2510 * NetRemoteTOD
2512 * @brief Query remote Time of Day
2514 * @param[in] server_name The server name to connect to
2515 * @param[out] buf The buffer containing a TIME_OF_DAY_INFO structure
2516 * @return NET_API_STATUS
2518 * example server/remote_tod.c
2519 ***************************************************************/
2521 NET_API_STATUS NetRemoteTOD(const char * server_name /* [in] */,
2522 uint8_t **buf /* [out] [ref] */);
2524 /************************************************************//**
2526 * NetShareAdd
2528 * @brief Add Share
2530 * @param[in] server_name The server name to connect to
2531 * @param[in] level The level defining the requested SHARE_INFO_X structure
2532 * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2533 * @param[out] parm_err The returned parameter error number if any
2534 * @return NET_API_STATUS
2536 * example share/share_add.c
2537 ***************************************************************/
2539 NET_API_STATUS NetShareAdd(const char * server_name /* [in] */,
2540 uint32_t level /* [in] */,
2541 uint8_t *buffer /* [in] [ref] */,
2542 uint32_t *parm_err /* [out] [ref] */);
2544 /************************************************************//**
2546 * NetShareDel
2548 * @brief Delete Share
2550 * @param[in] server_name The server name to connect to
2551 * @param[in] net_name The name of the share to delete
2552 * @param[in] reserved
2553 * @return NET_API_STATUS
2555 * example share/share_del.c
2556 ***************************************************************/
2558 NET_API_STATUS NetShareDel(const char * server_name /* [in] */,
2559 const char * net_name /* [in] */,
2560 uint32_t reserved /* [in] */);
2562 /************************************************************//**
2564 * NetShareEnum
2566 * @brief Enumerate Shares
2568 * @param[in] server_name The server name to connect to
2569 * @param[in] level The level defining the SHARE_INFO_X structure
2570 * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2571 * @param[in] prefmaxlen The requested maximal buffer size
2572 * @param[out] entries_read The number of SHARE_INFO_X entries in the buffer
2573 * @param[out] total_entries The total number of SHARE_INFO_X entries
2574 * @param[in,out] resume_handle A handle passed in and returned for resuming
2575 * operations
2576 * @return NET_API_STATUS
2578 * example share/share_enum.c
2579 ***************************************************************/
2581 NET_API_STATUS NetShareEnum(const char * server_name /* [in] */,
2582 uint32_t level /* [in] */,
2583 uint8_t **buffer /* [out] [ref] */,
2584 uint32_t prefmaxlen /* [in] */,
2585 uint32_t *entries_read /* [out] [ref] */,
2586 uint32_t *total_entries /* [out] [ref] */,
2587 uint32_t *resume_handle /* [in,out] [ref] */);
2589 /************************************************************//**
2591 * NetShareGetInfo
2593 * @brief Get Share Info
2595 * @param[in] server_name The server name to connect to
2596 * @param[in] net_name The name of the share to query
2597 * @param[in] level The level defining the SHARE_INFO_X structure
2598 * @param[out] buffer The buffer containing a SHARE_INFO_X structure
2599 * @return NET_API_STATUS
2601 * example share/share_getinfo.c
2602 ***************************************************************/
2604 NET_API_STATUS NetShareGetInfo(const char * server_name /* [in] */,
2605 const char * net_name /* [in] */,
2606 uint32_t level /* [in] */,
2607 uint8_t **buffer /* [out] [ref] */);
2609 /************************************************************//**
2611 * NetShareSetInfo
2613 * @brief Set Share Info
2615 * @param[in] server_name The server name to connect to
2616 * @param[in] net_name The name of the share to query
2617 * @param[in] level The level defining the SHARE_INFO_X structure
2618 * @param[in] buffer The buffer containing a SHARE_INFO_X structure
2619 * @param[out] parm_err The returned parameter error number if any
2620 * @return NET_API_STATUS
2622 * example share/share_setinfo.c
2623 ***************************************************************/
2625 NET_API_STATUS NetShareSetInfo(const char * server_name /* [in] */,
2626 const char * net_name /* [in] */,
2627 uint32_t level /* [in] */,
2628 uint8_t *buffer /* [in] [ref] */,
2629 uint32_t *parm_err /* [out] [ref] */);
2631 /************************************************************//**
2633 * NetFileClose
2635 * @brief Close a file
2637 * @param[in] server_name The server name to connect to
2638 * @param[in] fileid The fileid of the file that is going to be closed
2639 * @return NET_API_STATUS
2641 * example file/file_close.c
2642 ***************************************************************/
2644 NET_API_STATUS NetFileClose(const char * server_name /* [in] */,
2645 uint32_t fileid /* [in] */);
2647 /************************************************************//**
2649 * NetFileGetInfo
2651 * @brief Close a file
2653 * @param[in] server_name The server name to connect to
2654 * @param[in] fileid The fileid of the file that is going to be closed
2655 * @param[in] level The level of the FILE_INFO_X buffer
2656 * @param[out] buffer The buffer containing a FILE_INFO_X structure
2657 * @return NET_API_STATUS
2659 * example file/file_getinfo.c
2660 ***************************************************************/
2662 NET_API_STATUS NetFileGetInfo(const char * server_name /* [in] */,
2663 uint32_t fileid /* [in] */,
2664 uint32_t level /* [in] */,
2665 uint8_t **buffer /* [out] [ref] */);
2667 /************************************************************//**
2669 * NetFileEnum
2671 * @brief Enumerate Files
2673 * @param[in] server_name The server name to connect to
2674 * @param[in] base_path The
2675 * @param[in] user_name The
2676 * @param[in] level The level defining the FILE_INFO_X structure
2677 * @param[out] buffer The buffer containing a FILE_INFO_X structure
2678 * @param[in] prefmaxlen The requested maximal buffer size
2679 * @param[out] entries_read The number of FILE_INFO_X entries in the buffer
2680 * @param[out] total_entries The total number of FILE_INFO_X entries
2681 * @param[in,out] resume_handle A handle passed in and returned for resuming
2682 * operations
2683 * @return NET_API_STATUS
2685 * example file/file_enum.c
2686 ***************************************************************/
2688 NET_API_STATUS NetFileEnum(const char * server_name /* [in] */,
2689 const char * base_path /* [in] */,
2690 const char * user_name /* [in] */,
2691 uint32_t level /* [in] */,
2692 uint8_t **buffer /* [out] [ref] */,
2693 uint32_t prefmaxlen /* [in] */,
2694 uint32_t *entries_read /* [out] [ref] */,
2695 uint32_t *total_entries /* [out] [ref] */,
2696 uint32_t *resume_handle /* [in,out] [ref] */);
2698 /************************************************************//**
2700 * NetShutdownInit
2702 * @brief Start a machine shutdown
2704 * @param[in] server_name The server name to connect to
2705 * @param[in] message The message that is displayed before the shutdown
2706 * @param[in] timeout The amount of seconds to wait until shutting down
2707 * @param[in] force_apps Whether to close all applications before the shutdown
2708 * @param[in] do_reboot Whether to reboot after the shutdown
2709 * @return NET_API_STATUS
2711 * example shutdown/shutdown_init.c
2712 ***************************************************************/
2714 NET_API_STATUS NetShutdownInit(const char * server_name /* [in] */,
2715 const char * message /* [in] */,
2716 uint32_t timeout /* [in] */,
2717 uint8_t force_apps /* [in] */,
2718 uint8_t do_reboot /* [in] */);
2720 /************************************************************//**
2722 * NetShutdownAbort
2724 * @brief Abort an initiated machine shutdown
2726 * @param[in] server_name The server name to connect to
2727 * @return NET_API_STATUS
2729 * example shutdown/shutdown_abort.c
2730 ***************************************************************/
2732 NET_API_STATUS NetShutdownAbort(const char * server_name /* [in] */);
2734 /************************************************************//**
2736 * I_NetLogonControl
2738 * @brief Control various aspects of the NETLOGON service
2740 * @param[in] server_name The server name to connect to
2741 * @param[in] function_code The function code to call on the server
2742 * @param[in] query_level The level of the NETLOGON_INFO structure returned
2743 * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2744 * @return NET_API_STATUS
2746 * example netlogon/netlogon_control.c
2747 ***************************************************************/
2749 NET_API_STATUS I_NetLogonControl(const char * server_name /* [in] */,
2750 uint32_t function_code /* [in] */,
2751 uint32_t query_level /* [in] */,
2752 uint8_t **buffer /* [out] [ref] */);
2754 /************************************************************//**
2756 * I_NetLogonControl2
2758 * @brief Control various aspects of the NETLOGON service
2760 * @param[in] server_name The server name to connect to
2761 * @param[in] function_code The function code to call on the server
2762 * @param[in] query_level The level of the NETLOGON_INFO structure returned
2763 * @param[in] data The buffer containing information related to the function code
2764 * @param[out] buffer The returned buffer containing the NETLOGON_INFO structure
2765 * @return NET_API_STATUS
2767 * example netlogon/netlogon_control2.c
2768 ***************************************************************/
2770 NET_API_STATUS I_NetLogonControl2(const char * server_name /* [in] */,
2771 uint32_t function_code /* [in] */,
2772 uint32_t query_level /* [in] */,
2773 uint8_t *data /* [in] [ref] */,
2774 uint8_t **buffer /* [out] [ref] */);
2776 #ifdef __cplusplus
2778 #endif /* __cplusplus */
2780 #endif /* __LIB_NETAPI_H__ */