2 * Unix SMB/CIFS implementation.
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__
25 #endif /* __cplusplus */
27 /****************************************************************
29 ****************************************************************/
31 NET_API_STATUS_SUCCESS
= 0
34 #define ERROR_MORE_DATA ( 234L )
36 #define ENCRYPTED_PWLEN ( 16 )
38 /****************************************************************
39 ****************************************************************/
46 uint16_t time_hi_and_version
;
51 #endif /* _HEADER_misc */
53 #ifndef _HEADER_libnetapi
56 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
63 uint32_t sub_auths
[MAXSUBAUTHS
];
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
;
74 const char * dc_site_name
;
75 const char * client_site_name
;
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 )
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 )
98 #define TIMEQ_FOREVER ( (uint32_t)-1L )
100 enum NETSETUP_JOIN_STATUS
{
101 NetSetupUnknownStatus
=0,
103 NetSetupWorkgroupName
=2,
107 struct SERVER_INFO_100
{
108 uint32_t sv100_platform_id
;
109 const char * sv100_name
;
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
;
118 const char * sv101_comment
;
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
;
127 const char * sv102_comment
;
128 uint32_t sv102_users
;
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
;
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
;
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
;
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
;
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
;
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
;
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
;
378 struct SERVER_INFO_1005
{
379 const char * sv1005_comment
;
382 struct SERVER_INFO_1107
{
383 uint32_t sv1107_users
;
386 struct SERVER_INFO_1010
{
390 struct SERVER_INFO_1016
{
391 uint8_t sv1016_hidden
;
394 struct SERVER_INFO_1017
{
395 uint32_t sv1017_announce
;
398 struct SERVER_INFO_1018
{
399 uint32_t sv1018_anndelta
;
402 struct SERVER_INFO_1501
{
403 uint32_t sv1501_sessopens
;
406 struct SERVER_INFO_1502
{
407 uint32_t sv1502_sessvcs
;
410 struct SERVER_INFO_1503
{
411 uint32_t sv1503_opensearch
;
414 struct SERVER_INFO_1506
{
415 uint32_t sv1506_maxworkitems
;
418 struct SERVER_INFO_1509
{
419 uint32_t sv1509_maxrawbuflen
;
422 struct SERVER_INFO_1510
{
423 uint32_t sv1510_sessusers
;
426 struct SERVER_INFO_1511
{
427 uint32_t sv1511_sessconns
;
430 struct SERVER_INFO_1512
{
431 uint32_t sv1512_maxnonpagedmemoryusage
;
434 struct SERVER_INFO_1513
{
435 uint32_t sv1513_maxpagedmemoryusage
;
438 struct SERVER_INFO_1514
{
439 uint8_t sv1514_enablesoftcompat
;
442 struct SERVER_INFO_1515
{
443 uint8_t sv1515_enableforcedlogoff
;
446 struct SERVER_INFO_1516
{
447 uint8_t sv1516_timesource
;
450 struct SERVER_INFO_1518
{
451 uint8_t sv1518_lmannounce
;
454 struct SERVER_INFO_1520
{
455 uint32_t sv1520_maxcopyreadlen
;
458 struct SERVER_INFO_1521
{
459 uint32_t sv1521_maxcopywritelen
;
462 struct SERVER_INFO_1522
{
463 uint32_t sv1522_minkeepsearch
;
466 struct SERVER_INFO_1523
{
467 uint32_t sv1523_maxkeepsearch
;
470 struct SERVER_INFO_1524
{
471 uint32_t sv1524_minkeepcomplsearch
;
474 struct SERVER_INFO_1525
{
475 uint32_t sv1525_maxkeepcomplsearch
;
478 struct SERVER_INFO_1528
{
479 uint32_t sv1528_scavtimeout
;
482 struct SERVER_INFO_1529
{
483 uint32_t sv1529_minrcvqueue
;
486 struct SERVER_INFO_1530
{
487 uint32_t sv1530_minfreeworkitems
;
490 struct SERVER_INFO_1533
{
491 uint32_t sv1533_maxmpxct
;
494 struct SERVER_INFO_1534
{
495 uint32_t sv1534_oplockbreakwait
;
498 struct SERVER_INFO_1535
{
499 uint32_t sv1535_oplockbreakresponsewait
;
502 struct SERVER_INFO_1536
{
503 uint8_t sv1536_enableoplocks
;
506 struct SERVER_INFO_1537
{
507 uint8_t sv1537_enableoplockforceclose
;
510 struct SERVER_INFO_1538
{
511 uint8_t sv1538_enablefcbopens
;
514 struct SERVER_INFO_1539
{
515 uint8_t sv1539_enableraw
;
518 struct SERVER_INFO_1540
{
519 uint8_t sv1540_enablesharednetdrives
;
522 struct SERVER_INFO_1541
{
523 uint8_t sv1541_minfreeconnections
;
526 struct SERVER_INFO_1542
{
527 uint8_t sv1542_maxfreeconnections
;
530 struct SERVER_INFO_1543
{
531 uint32_t sv1543_initsesstable
;
534 struct SERVER_INFO_1544
{
535 uint32_t sv1544_initconntable
;
538 struct SERVER_INFO_1545
{
539 uint32_t sv1545_initfiletable
;
542 struct SERVER_INFO_1546
{
543 uint32_t sv1546_initsearchtable
;
546 struct SERVER_INFO_1547
{
547 uint32_t sv1547_alertschedule
;
550 struct SERVER_INFO_1548
{
551 uint32_t sv1548_errorthreshold
;
554 struct SERVER_INFO_1549
{
555 uint32_t sv1549_networkerrorthreshold
;
558 struct SERVER_INFO_1550
{
559 uint32_t sv1550_diskspacethreshold
;
562 struct SERVER_INFO_1552
{
563 uint32_t sv1552_maxlinkdelay
;
566 struct SERVER_INFO_1553
{
567 uint32_t sv1553_minlinkthroughput
;
570 struct SERVER_INFO_1554
{
571 uint32_t sv1554_linkinfovalidtime
;
574 struct SERVER_INFO_1555
{
575 uint32_t sv1555_scavqosinfoupdatetime
;
578 struct SERVER_INFO_1556
{
579 uint32_t sv1556_maxworkitemidletime
;
582 struct SERVER_INFO_1557
{
583 uint32_t sv1557_maxrawworkitems
;
586 struct SERVER_INFO_1560
{
587 uint32_t sv1560_producttype
;
590 struct SERVER_INFO_1561
{
591 uint32_t sv1561_serversize
;
594 struct SERVER_INFO_1562
{
595 uint32_t sv1562_connectionlessautodisc
;
598 struct SERVER_INFO_1563
{
599 uint32_t sv1563_sharingviolationretries
;
602 struct SERVER_INFO_1564
{
603 uint32_t sv1564_sharingviolationdelay
;
606 struct SERVER_INFO_1565
{
607 uint32_t sv1565_maxglobalopensearch
;
610 struct SERVER_INFO_1566
{
611 uint8_t sv1566_removeduplicatesearches
;
614 struct SERVER_INFO_1567
{
615 uint32_t sv1567_lockviolationretries
;
618 struct SERVER_INFO_1568
{
619 uint32_t sv1568_lockviolationoffset
;
622 struct SERVER_INFO_1569
{
623 uint32_t sv1569_lockviolationdelay
;
626 struct SERVER_INFO_1570
{
627 uint32_t sv1570_mdlreadswitchover
;
630 struct SERVER_INFO_1571
{
631 uint32_t sv1571_cachedopenlimit
;
634 struct SERVER_INFO_1572
{
635 uint32_t sv1572_criticalthreads
;
638 struct SERVER_INFO_1573
{
639 uint32_t sv1573_restrictnullsessaccess
;
642 struct SERVER_INFO_1574
{
643 uint32_t sv1574_enablewfw311directipx
;
646 struct SERVER_INFO_1575
{
647 uint32_t sv1575_otherqueueaffinity
;
650 struct SERVER_INFO_1576
{
651 uint32_t sv1576_queuesamplesecs
;
654 struct SERVER_INFO_1577
{
655 uint32_t sv1577_balancecount
;
658 struct SERVER_INFO_1578
{
659 uint32_t sv1578_preferredaffinity
;
662 struct SERVER_INFO_1579
{
663 uint32_t sv1579_maxfreerfcbs
;
666 struct SERVER_INFO_1580
{
667 uint32_t sv1580_maxfreemfcbs
;
670 struct SERVER_INFO_1581
{
671 uint32_t sv1581_maxfreemlcbs
;
674 struct SERVER_INFO_1582
{
675 uint32_t sv1582_maxfreepagedpoolchunks
;
678 struct SERVER_INFO_1583
{
679 uint32_t sv1583_minpagedpoolchunksize
;
682 struct SERVER_INFO_1584
{
683 uint32_t sv1584_maxpagedpoolchunksize
;
686 struct SERVER_INFO_1585
{
687 uint8_t sv1585_sendsfrompreferredprocessor
;
690 struct SERVER_INFO_1586
{
691 uint32_t sv1586_maxthreadsperqueue
;
694 struct SERVER_INFO_1587
{
695 uint32_t sv1587_cacheddirectorylimit
;
698 struct SERVER_INFO_1588
{
699 uint32_t sv1588_maxcopylength
;
702 struct SERVER_INFO_1590
{
703 uint32_t sv1590_enablecompression
;
706 struct SERVER_INFO_1591
{
707 uint32_t sv1591_autosharewks
;
710 struct SERVER_INFO_1592
{
711 uint32_t sv1592_autosharewks
;
714 struct SERVER_INFO_1593
{
715 uint32_t sv1593_enablesecuritysignature
;
718 struct SERVER_INFO_1594
{
719 uint32_t sv1594_requiresecuritysignature
;
722 struct SERVER_INFO_1595
{
723 uint32_t sv1595_minclientbuffersize
;
726 struct SERVER_INFO_1596
{
727 uint32_t sv1596_ConnectionNoSessionsTimeout
;
730 struct SERVER_INFO_1597
{
731 uint32_t sv1597_IdleThreadTimeOut
;
734 struct SERVER_INFO_1598
{
735 uint32_t sv1598_enableW9xsecuritysignature
;
738 struct SERVER_INFO_1599
{
739 uint8_t sv1598_enforcekerberosreauthentication
;
742 struct SERVER_INFO_1600
{
743 uint8_t sv1598_disabledos
;
746 struct SERVER_INFO_1601
{
747 uint32_t sv1598_lowdiskspaceminimum
;
750 struct SERVER_INFO_1602
{
751 uint8_t sv_1598_disablestrictnamechecking
;
755 const char * usri0_name
;
758 #define USER_PRIV_GUEST ( 0 )
759 #define USER_PRIV_USER ( 1 )
760 #define USER_PRIV_ADMIN ( 2 )
763 const char * usri1_name
;
764 const char * usri1_password
;
765 uint32_t usri1_password_age
;
767 const char * usri1_home_dir
;
768 const char * usri1_comment
;
769 uint32_t usri1_flags
;
770 const char * usri1_script_path
;
773 #define AF_OP_PRINT ( 0x1 )
774 #define AF_OP_COMM ( 0x2 )
775 #define AF_OP_SERVER ( 0x4 )
776 #define AF_OP_ACCOUNTS ( 0x8 )
779 const char * usri2_name
;
780 const char * usri2_password
;
781 uint32_t usri2_password_age
;
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
;
806 const char * usri3_name
;
807 uint32_t usri3_password_age
;
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
;
837 const char * usri4_name
;
838 const char * usri4_password
;
839 uint32_t usri4_password_age
;
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
;
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
;
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
;
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
;
906 struct USER_INFO_21
{
907 uint8_t *usri21_password
;
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
;
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] */
945 struct USER_INFO_1003
{
946 const char * usri1003_password
;
949 struct USER_INFO_1005
{
950 uint32_t usri1005_priv
;
953 struct USER_INFO_1006
{
954 const char * usri1006_home_dir
;
957 struct USER_INFO_1007
{
958 const char * usri1007_comment
;
961 struct USER_INFO_1008
{
962 uint32_t usri1008_flags
;
965 struct USER_INFO_1009
{
966 const char * usri1009_script_path
;
969 struct USER_INFO_1010
{
970 uint32_t usri1010_auth_flags
;
973 struct USER_INFO_1011
{
974 const char * usri1011_full_name
;
977 struct USER_INFO_1012
{
978 const char * usri1012_usr_comment
;
981 struct USER_INFO_1013
{
982 const char * usri1013_parms
;
985 struct USER_INFO_1014
{
986 const char * usri1014_workstations
;
989 struct USER_INFO_1017
{
990 uint32_t usri1017_acct_expires
;
993 struct USER_INFO_1018
{
994 uint32_t usri1018_max_storage
;
997 struct USER_INFO_1020
{
998 uint32_t usri1020_units_per_week
;
999 uint8_t *usri1020_logon_hours
;/* [unique] */
1002 struct USER_INFO_1023
{
1003 const char * usri1023_logon_server
;
1006 struct USER_INFO_1024
{
1007 uint32_t usri1024_country_code
;
1010 struct USER_INFO_1025
{
1011 uint32_t usri1025_code_page
;
1014 struct USER_INFO_1051
{
1015 uint32_t usri1051_primary_group_id
;
1018 struct USER_INFO_1052
{
1019 const char * usri1052_profile
;
1022 struct USER_INFO_1053
{
1023 const char * usri1053_home_dir_drive
;
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
;
1034 struct USER_MODALS_INFO_1
{
1035 uint32_t usrmod1_role
;
1036 const char * usrmod1_primary
;
1039 struct USER_MODALS_INFO_2
{
1040 const char * usrmod2_domain_name
;
1041 struct domsid
*usrmod2_domain_id
;/* [unique] */
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
;
1050 struct USER_MODALS_INFO_1001
{
1051 uint32_t usrmod1001_min_passwd_len
;
1054 struct USER_MODALS_INFO_1002
{
1055 uint32_t usrmod1002_max_passwd_age
;
1058 struct USER_MODALS_INFO_1003
{
1059 uint32_t usrmod1003_min_passwd_age
;
1062 struct USER_MODALS_INFO_1004
{
1063 uint32_t usrmod1004_force_logoff
;
1066 struct USER_MODALS_INFO_1005
{
1067 uint32_t usrmod1005_password_hist_len
;
1070 struct USER_MODALS_INFO_1006
{
1071 uint32_t usrmod1006_role
;
1074 struct USER_MODALS_INFO_1007
{
1075 const char * usrmod1007_primary
;
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
;
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
;
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
;
1103 struct GROUP_INFO_0
{
1104 const char * grpi0_name
;
1107 struct GROUP_INFO_1
{
1108 const char * grpi1_name
;
1109 const char * grpi1_comment
;
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
;
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
;
1126 struct GROUP_INFO_1002
{
1127 const char * grpi1002_comment
;
1130 struct GROUP_INFO_1005
{
1131 uint32_t grpi1005_attributes
;
1134 struct GROUP_USERS_INFO_0
{
1135 const char * grui0_name
;
1138 struct GROUP_USERS_INFO_1
{
1139 const char * grui1_name
;
1140 uint32_t grui1_attributes
;
1143 struct LOCALGROUP_INFO_0
{
1144 const char * lgrpi0_name
;
1147 struct LOCALGROUP_INFO_1
{
1148 const char * lgrpi1_name
;
1149 const char * lgrpi1_comment
;
1152 struct LOCALGROUP_INFO_1002
{
1153 const char * lgrpi1002_comment
;
1161 SidTypeWellKnownGroup
=5,
1162 SidTypeDeletedAccount
=6,
1169 struct LOCALGROUP_MEMBERS_INFO_0
{
1170 struct domsid
*lgrmi0_sid
;/* [unique] */
1173 struct LOCALGROUP_MEMBERS_INFO_1
{
1174 struct domsid
*lgrmi1_sid
;/* [unique] */
1175 enum SID_NAME_USE lgrmi1_sidusage
;
1176 const char * lgrmi1_name
;
1179 struct LOCALGROUP_MEMBERS_INFO_2
{
1180 struct domsid
*lgrmi2_sid
;/* [unique] */
1181 enum SID_NAME_USE lgrmi2_sidusage
;
1182 const char * lgrmi2_domainandname
;
1185 struct LOCALGROUP_MEMBERS_INFO_3
{
1186 const char * lgrmi3_domainandname
;
1189 struct LOCALGROUP_USERS_INFO_0
{
1190 const char * lgrui0_name
;
1193 struct TIME_OF_DAY_INFO
{
1194 uint32_t tod_elapsedt
;
1200 int32_t tod_timezone
;
1201 uint32_t tod_tinterval
;
1205 uint32_t tod_weekday
;
1208 struct SHARE_INFO_0
{
1209 const char * shi0_netname
;
1212 struct SHARE_INFO_1
{
1213 const char * shi1_netname
;
1215 const char * shi1_remark
;
1218 struct SHARE_INFO_2
{
1219 const char * shi2_netname
;
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
;
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
;
1236 struct SHARE_INFO_1004
{
1237 const char * shi1004_remark
;
1240 struct SHARE_INFO_1005
{
1241 uint32_t shi1005_flags
;
1244 struct SHARE_INFO_1006
{
1245 uint32_t shi1006_max_uses
;
1248 struct FILE_INFO_2
{
1252 struct FILE_INFO_3
{
1254 uint32_t fi3_permissions
;
1255 uint32_t fi3_num_locks
;
1256 const char * fi3_pathname
;
1257 const char * fi3_username
;
1260 struct NETLOGON_INFO_1
{
1261 uint32_t netlog1_flags
;
1262 NET_API_STATUS netlog1_pdc_connection_status
;
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
;
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
;
1282 struct NETLOGON_INFO_4
{
1283 const char * netlog4_trusted_dc_name
;
1284 const char * netlog4_trusted_domain_name
;
1287 #endif /* _HEADER_libnetapi */
1289 #ifndef _HEADER_netlogon
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 )
1308 #endif /* _HEADER_netlogon */
1310 /****************************************************************
1311 ****************************************************************/
1313 struct libnetapi_ctx
{
1322 int disable_policy_handle_cache
;
1327 /****************************************************************
1328 ****************************************************************/
1330 NET_API_STATUS
libnetapi_init(struct libnetapi_ctx
**ctx
);
1332 /****************************************************************
1333 ****************************************************************/
1335 NET_API_STATUS
libnetapi_free(struct libnetapi_ctx
*ctx
);
1337 /****************************************************************
1338 ****************************************************************/
1340 NET_API_STATUS
libnetapi_getctx(struct libnetapi_ctx
**ctx
);
1342 /****************************************************************
1343 ****************************************************************/
1345 NET_API_STATUS
libnetapi_set_debuglevel(struct libnetapi_ctx
*ctx
,
1346 const char *debuglevel
);
1348 /****************************************************************
1349 ****************************************************************/
1351 NET_API_STATUS
libnetapi_set_username(struct libnetapi_ctx
*ctx
,
1352 const char *username
);
1354 /****************************************************************
1355 ****************************************************************/
1357 NET_API_STATUS
libnetapi_set_password(struct libnetapi_ctx
*ctx
,
1358 const char *password
);
1360 /****************************************************************
1361 ****************************************************************/
1363 NET_API_STATUS
libnetapi_set_workgroup(struct libnetapi_ctx
*ctx
,
1364 const char *workgroup
);
1366 /****************************************************************
1367 ****************************************************************/
1369 NET_API_STATUS
libnetapi_set_use_kerberos(struct libnetapi_ctx
*ctx
);
1371 /****************************************************************
1372 ****************************************************************/
1374 NET_API_STATUS
libnetapi_set_use_ccache(struct libnetapi_ctx
*ctx
);
1376 /****************************************************************
1377 ****************************************************************/
1379 const char *libnetapi_errstr(NET_API_STATUS status
);
1381 /****************************************************************
1382 ****************************************************************/
1384 const char *libnetapi_get_error_string(struct libnetapi_ctx
*ctx
,
1385 NET_API_STATUS status
);
1387 /****************************************************************
1388 NetApiBufferAllocate
1389 ****************************************************************/
1391 NET_API_STATUS
NetApiBufferAllocate(uint32_t byte_count
,
1394 /****************************************************************
1396 ****************************************************************/
1398 NET_API_STATUS
NetApiBufferFree(void *buffer
);
1400 /************************************************************//**
1402 * ConvertSidToStringSid
1404 * @brief Convert a domain sid into a string
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)
1410 ***************************************************************/
1412 int ConvertSidToStringSid(const struct domsid
*sid
,
1415 /************************************************************//**
1417 * ConvertStringSidToSid
1419 * @brief Convert a string into a domain sid
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)
1425 ***************************************************************/
1427 int ConvertStringSidToSid(const char *sid_string
,
1428 struct domsid
**sid
);
1430 /************************************************************//**
1434 * @brief Join a computer to a domain or workgroup
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
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
1445 * example netdomjoin/netdomjoin.c
1446 ***************************************************************/
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] */);
1455 /************************************************************//**
1459 * @brief Unjoin a computer from a domain or workgroup
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
1467 ***************************************************************/
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] */);
1474 /************************************************************//**
1476 * NetGetJoinInformation
1478 * @brief Unjoin a computer from a domain or workgroup
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
1485 * example netdomjoin-gui/netdomjoin-gui.c
1487 ***************************************************************/
1489 NET_API_STATUS
NetGetJoinInformation(const char * server_name
/* [in] */,
1490 const char * *name_buffer
/* [out] [ref] */,
1491 uint16_t *name_type
/* [out] [ref] */);
1493 /************************************************************//**
1497 * @brief Query for the list of joinable organizational Units that can be used
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
1508 * example netdomjoin-gui/netdomjoin-gui.c
1510 ***************************************************************/
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] */);
1519 /************************************************************//**
1521 * NetRenameMachineInDomain
1523 * @brief Rename a machine in a domain
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
1532 * example join/rename_machine.c
1534 ***************************************************************/
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] */);
1542 /************************************************************//**
1546 * @brief Get Information on a server
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
1553 ***************************************************************/
1555 NET_API_STATUS
NetServerGetInfo(const char * server_name
/* [in] */,
1556 uint32_t level
/* [in] */,
1557 uint8_t **buffer
/* [out] [ref] */);
1559 /************************************************************//**
1563 * @brief Get Information on a server
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
1571 ***************************************************************/
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] */);
1578 /************************************************************//**
1582 * @brief Query for the PDC for a given domain
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
1589 * example getdc/getdc.c
1590 ***************************************************************/
1592 NET_API_STATUS
NetGetDCName(const char * server_name
/* [in] */,
1593 const char * domain_name
/* [in] */,
1594 uint8_t **buffer
/* [out] [ref] */);
1596 /************************************************************//**
1600 * @brief Query for any DC for a given domain
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
1607 * example getdc/getdc.c
1608 ***************************************************************/
1610 NET_API_STATUS
NetGetAnyDCName(const char * server_name
/* [in] */,
1611 const char * domain_name
/* [in] */,
1612 uint8_t **buffer
/* [out] [ref] */);
1615 /************************************************************//**
1619 * @brief Lookup a DC for a given domain and return information structure
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
1629 * example dsgetdc/dsgetdc.c
1630 ***************************************************************/
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] */);
1639 /************************************************************//**
1643 * @brief Create a user on a given server
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
1651 * @return NET_API_STATUS
1653 * example user/user_add.c
1654 ***************************************************************/
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] */);
1661 /************************************************************//**
1665 * @brief Delete a user on a given server
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
1671 * example user/user_del.c
1672 ***************************************************************/
1674 NET_API_STATUS
NetUserDel(const char * server_name
/* [in] */,
1675 const char * user_name
/* [in] */);
1677 /************************************************************//**
1681 * @brief Enumerate accounts on a server
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
1693 * @return NET_API_STATUS
1695 * example user/user_enum.c
1696 ***************************************************************/
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] */);
1707 /************************************************************//**
1709 * NetUserChangePassword
1711 * @brief Change the password for a user on a given server or in a given domain
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
1719 * example user/user_chgpwd.c
1720 ***************************************************************/
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] */);
1727 /************************************************************//**
1731 * @brief Get User Information
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
1739 * example user/user_getinfo.c
1740 ***************************************************************/
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] */);
1747 /************************************************************//**
1751 * @brief Set User Information
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
1760 * example user/user_setinfo.c
1761 ***************************************************************/
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] */);
1769 /************************************************************//**
1773 * @brief Get SAM domain and password information
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
1780 * example user/user_modalsget.c
1781 ***************************************************************/
1783 NET_API_STATUS
NetUserModalsGet(const char * server_name
/* [in] */,
1784 uint32_t level
/* [in] */,
1785 uint8_t **buffer
/* [out] [ref] */);
1787 /************************************************************//**
1791 * @brief Set SAM domain and password information
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
1799 * example user/user_modalsset.c
1800 ***************************************************************/
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] */);
1807 /************************************************************//**
1811 * @brief Enumerate grouplist of a user on a server
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
1823 * example user/user_getgroups.c
1824 ***************************************************************/
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] */);
1834 /************************************************************//**
1838 * @brief Set grouplist of a user on a server
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
1847 * example user/user_setgroups.c
1848 ***************************************************************/
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] */);
1856 /************************************************************//**
1858 * NetUserGetLocalGroups
1860 * @brief Enumerate local grouplist of a user on a server
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
1872 * example user/user_getlocalgroups.c
1873 ***************************************************************/
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] */);
1884 /************************************************************//**
1886 * NetQueryDisplayInformation
1888 * @brief Enumerate accounts on a server
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
1899 * example user/user_dispinfo.c
1900 ***************************************************************/
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] */);
1910 /************************************************************//**
1914 * @brief Create Domain Group
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
1922 * example group/group_add.c
1923 ***************************************************************/
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] */);
1930 /************************************************************//**
1934 * @brief Delete Domain Group
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
1940 * example group/group_del.c
1941 ***************************************************************/
1943 NET_API_STATUS
NetGroupDel(const char * server_name
/* [in] */,
1944 const char * group_name
/* [in] */);
1946 /************************************************************//**
1950 * @brief Enumerate groups on a server
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
1961 * @return NET_API_STATUS
1963 * example group/group_enum.c
1964 ***************************************************************/
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] */);
1974 /************************************************************//**
1978 * @brief Set Domain Group Information
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
1987 * example group/group_setinfo.c
1988 ***************************************************************/
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] */);
1996 /************************************************************//**
2000 * @brief Get Domain Group Information
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
2008 * example group/group_getinfo.c
2009 ***************************************************************/
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] */);
2016 /************************************************************//**
2020 * @brief Add existing User to existing Domain Group
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
2026 * @return NET_API_STATUS
2028 * example group/group_adduser.c
2029 ***************************************************************/
2031 NET_API_STATUS
NetGroupAddUser(const char * server_name
/* [in] */,
2032 const char * group_name
/* [in] */,
2033 const char * user_name
/* [in] */);
2035 /************************************************************//**
2039 * @brief Remove User from Domain Group
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
2045 * @return NET_API_STATUS
2047 * example group/group_deluser.c
2048 ***************************************************************/
2050 NET_API_STATUS
NetGroupDelUser(const char * server_name
/* [in] */,
2051 const char * group_name
/* [in] */,
2052 const char * user_name
/* [in] */);
2054 /************************************************************//**
2058 * @brief Get Users for a group on a server
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
2069 * @return NET_API_STATUS
2071 * example group/group_getusers.c
2072 ***************************************************************/
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] */);
2083 /************************************************************//**
2087 * @brief Set Users for a group on a server
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
2096 * example group/group_setusers.c
2097 ***************************************************************/
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] */);
2105 /************************************************************//**
2109 * @brief Create Local Group
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
2117 * example localgroup/localgroup_add.c
2118 ***************************************************************/
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] */);
2125 /************************************************************//**
2129 * @brief Delete Local Group
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
2135 * example localgroup/localgroup_del.c
2136 ***************************************************************/
2139 NET_API_STATUS
NetLocalGroupDel(const char * server_name
/* [in] */,
2140 const char * group_name
/* [in] */);
2142 /************************************************************//**
2144 * NetLocalGroupGetInfo
2146 * @brief Get Local Group Information
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
2154 * example localgroup/localgroup_getinfo.c
2155 ***************************************************************/
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] */);
2162 /************************************************************//**
2164 * NetLocalGroupSetInfo
2166 * @brief Set Local Group Information
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
2175 * example localgroup/localgroup_setinfo.c
2176 ***************************************************************/
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] */);
2185 /************************************************************//**
2189 * @brief Enumerate local groups on a server
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
2200 * @return NET_API_STATUS
2202 * example localgroup/localgroup_enum.c
2203 ***************************************************************/
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] */);
2213 /************************************************************//**
2215 * NetLocalGroupAddMembers
2217 * @brief Add Members to a Local Group
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
2225 * @return NET_API_STATUS
2227 * example localgroup/localgroup_addmembers.c
2228 ***************************************************************/
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] */);
2236 /************************************************************//**
2238 * NetLocalGroupDelMembers
2240 * @brief Delete Members from a Local Group
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
2248 * @return NET_API_STATUS
2250 * example localgroup/localgroup_delmembers.c
2251 ***************************************************************/
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] */);
2259 /************************************************************//**
2261 * NetLocalGroupGetMembers
2263 * @brief Enumerate Members in a local group
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
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
2275 * @return NET_API_STATUS
2277 * example localgroup/localgroup_getmembers.c
2278 ***************************************************************/
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] */);
2289 /************************************************************//**
2291 * NetLocalGroupSetMembers
2293 * @brief Set Members in a Local Group
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
2301 * @return NET_API_STATUS
2303 * example localgroup/localgroup_setmembers.c
2304 ***************************************************************/
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] */);
2312 /************************************************************//**
2316 * @brief Query remote Time of Day
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
2322 * example server/remote_tod.c
2323 ***************************************************************/
2325 NET_API_STATUS
NetRemoteTOD(const char * server_name
/* [in] */,
2326 uint8_t **buf
/* [out] [ref] */);
2328 /************************************************************//**
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
2340 * example share/share_add.c
2341 ***************************************************************/
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] */);
2348 /************************************************************//**
2352 * @brief Delete Share
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
2359 * example share/share_del.c
2360 ***************************************************************/
2362 NET_API_STATUS
NetShareDel(const char * server_name
/* [in] */,
2363 const char * net_name
/* [in] */,
2364 uint32_t reserved
/* [in] */);
2366 /************************************************************//**
2370 * @brief Enumerate Shares
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
2380 * @return NET_API_STATUS
2382 * example share/share_enum.c
2383 ***************************************************************/
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] */);
2393 /************************************************************//**
2397 * @brief Get Share Info
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
2405 * example share/share_getinfo.c
2406 ***************************************************************/
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] */);
2413 /************************************************************//**
2417 * @brief Set Share Info
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
2426 * example share/share_setinfo.c
2427 ***************************************************************/
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] */);
2435 /************************************************************//**
2439 * @brief Close a file
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
2445 * example file/file_close.c
2446 ***************************************************************/
2448 NET_API_STATUS
NetFileClose(const char * server_name
/* [in] */,
2449 uint32_t fileid
/* [in] */);
2451 /************************************************************//**
2455 * @brief Close a file
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
2463 * example file/file_getinfo.c
2464 ***************************************************************/
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] */);
2471 /************************************************************//**
2475 * @brief Enumerate Files
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
2487 * @return NET_API_STATUS
2489 * example file/file_enum.c
2490 ***************************************************************/
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] */);
2502 /************************************************************//**
2506 * @brief Start a machine shutdown
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
2515 * example shutdown/shutdown_init.c
2516 ***************************************************************/
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] */);
2524 /************************************************************//**
2528 * @brief Abort an initiated machine shutdown
2530 * @param[in] server_name The server name to connect to
2531 * @return NET_API_STATUS
2533 * example shutdown/shutdown_abort.c
2534 ***************************************************************/
2536 NET_API_STATUS
NetShutdownAbort(const char * server_name
/* [in] */);
2538 /************************************************************//**
2542 * @brief Control various aspects of the NETLOGON service
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
2550 * example netlogon/netlogon_control.c
2551 ***************************************************************/
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] */);
2558 /************************************************************//**
2560 * I_NetLogonControl2
2562 * @brief Control various aspects of the NETLOGON service
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
2571 * example netlogon/netlogon_control2.c
2572 ***************************************************************/
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] */);
2582 #endif /* __cplusplus */
2584 #endif /* __LIB_NETAPI_H__ */