2 * Unix SMB/CIFS implementation.
4 * Copyright (C) Guenther Deschner 2007-2008
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 /****************************************************************
25 ****************************************************************/
27 NET_API_STATUS_SUCCESS = 0
30 #define ERROR_MORE_DATA ( 234L )
32 /****************************************************************
33 ****************************************************************/
40 uint16_t time_hi_and_version;
45 #endif /* _HEADER_misc */
47 #ifndef _HEADER_libnetapi
50 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
57 uint32_t sub_auths[MAXSUBAUTHS];
60 struct DOMAIN_CONTROLLER_INFO {
61 const char * domain_controller_name;
62 const char * domain_controller_address;
63 uint32_t domain_controller_address_type;
64 struct GUID domain_guid;
65 const char * domain_name;
66 const char * dns_forest_name;
68 const char * dc_site_name;
69 const char * client_site_name;
72 #define FILTER_TEMP_DUPLICATE_ACCOUNT ( 0x0001 )
73 #define FILTER_NORMAL_ACCOUNT ( 0x0002 )
74 #define FILTER_INTERDOMAIN_TRUST_ACCOUNT ( 0x0008 )
75 #define FILTER_WORKSTATION_TRUST_ACCOUNT ( 0x0010 )
76 #define FILTER_SERVER_TRUST_ACCOUNT ( 0x0020 )
78 struct SERVER_INFO_1005 {
79 const char * sv1005_comment;
83 const char * usri0_name;
87 const char * usri1_name;
88 const char * usri1_password;
89 uint32_t usri1_password_age;
91 const char * usri1_home_dir;
92 const char * usri1_comment;
94 const char * usri1_script_path;
98 const char * usri2_name;
99 const char * usri2_password;
100 uint32_t usri2_password_age;
102 const char * usri2_home_dir;
103 const char * usri2_comment;
104 uint32_t usri2_flags;
105 const char * usri2_script_path;
106 uint32_t usri2_auth_flags;
107 const char * usri2_full_name;
108 const char * usri2_usr_comment;
109 const char * usri2_parms;
110 const char * usri2_workstations;
111 uint32_t usri2_last_logon;
112 uint32_t usri2_last_logoff;
113 uint32_t usri2_acct_expires;
114 uint32_t usri2_max_storage;
115 uint32_t usri2_units_per_week;
116 uint8_t *usri2_logon_hours;/* [unique] */
117 uint32_t usri2_bad_pw_count;
118 uint32_t usri2_num_logons;
119 const char * usri2_logon_server;
120 uint32_t usri2_country_code;
121 uint32_t usri2_code_page;
125 const char * usri3_name;
126 uint32_t usri3_password_age;
128 const char * usri3_home_dir;
129 const char * usri3_comment;
130 uint32_t usri3_flags;
131 const char * usri3_script_path;
132 uint32_t usri3_auth_flags;
133 const char * usri3_full_name;
134 const char * usri3_usr_comment;
135 const char * usri3_parms;
136 const char * usri3_workstations;
137 uint32_t usri3_last_logon;
138 uint32_t usri3_last_logoff;
139 uint32_t usri3_acct_expires;
140 uint32_t usri3_max_storage;
141 uint32_t usri3_units_per_week;
142 uint8_t *usri3_logon_hours;/* [unique] */
143 uint32_t usri3_bad_pw_count;
144 uint32_t usri3_num_logons;
145 const char * usri3_logon_server;
146 uint32_t usri3_country_code;
147 uint32_t usri3_code_page;
148 uint32_t usri3_user_id;
149 uint32_t usri3_primary_group_id;
150 const char * usri3_profile;
151 const char * usri3_home_dir_drive;
152 uint32_t usri3_password_expired;
156 const char * usri4_name;
157 const char * usri4_password;
158 uint32_t usri4_password_age;
160 const char * usri4_home_dir;
161 const char * usri4_comment;
162 uint32_t usri4_flags;
163 const char * usri4_script_path;
164 uint32_t usri4_auth_flags;
165 const char * usri4_full_name;
166 const char * usri4_usr_comment;
167 const char * usri4_parms;
168 const char * usri4_workstations;
169 uint32_t usri4_last_logon;
170 uint32_t usri4_last_logoff;
171 uint32_t usri4_acct_expires;
172 uint32_t usri4_max_storage;
173 uint32_t usri4_units_per_week;
174 uint8_t *usri4_logon_hours;/* [unique] */
175 uint32_t usri4_bad_pw_count;
176 uint32_t usri4_num_logons;
177 const char * usri4_logon_server;
178 uint32_t usri4_country_code;
179 uint32_t usri4_code_page;
180 struct dom_sid *usri4_user_sid;/* [unique] */
181 uint32_t usri4_primary_group_id;
182 const char * usri4_profile;
183 const char * usri4_home_dir_drive;
184 uint32_t usri4_password_expired;
187 struct USER_INFO_10 {
188 const char * usri10_name;
189 const char * usri10_comment;
190 const char * usri10_usr_comment;
191 const char * usri10_full_name;
194 struct USER_INFO_11 {
195 const char * usri11_name;
196 const char * usri11_comment;
197 const char * usri11_usr_comment;
198 const char * usri11_full_name;
199 uint32_t usri11_priv;
200 uint32_t usri11_auth_flags;
201 uint32_t usri11_password_age;
202 const char * usri11_home_dir;
203 const char * usri11_parms;
204 uint32_t usri11_last_logon;
205 uint32_t usri11_last_logoff;
206 uint32_t usri11_bad_pw_count;
207 uint32_t usri11_num_logons;
208 const char * usri11_logon_server;
209 uint32_t usri11_country_code;
210 const char * usri11_workstations;
211 uint32_t usri11_max_storage;
212 uint32_t usri11_units_per_week;
213 uint8_t *usri11_logon_hours;/* [unique] */
214 uint32_t usri11_code_page;
217 struct USER_INFO_20 {
218 const char * usri20_name;
219 const char * usri20_full_name;
220 const char * usri20_comment;
221 uint32_t usri20_flags;
222 uint32_t usri20_user_id;
225 struct USER_INFO_23 {
226 const char * usri23_name;
227 const char * usri23_full_name;
228 const char * usri23_comment;
229 uint32_t usri23_flags;
230 struct domsid *usri23_user_sid;/* [unique] */
233 struct USER_INFO_1007 {
234 const char * usri1007_comment;
237 struct NET_DISPLAY_USER {
238 const char * usri1_name;
239 const char * usri1_comment;
240 uint32_t usri1_flags;
241 const char * usri1_full_name;
242 uint32_t usri1_user_id;
243 uint32_t usri1_next_index;
246 struct NET_DISPLAY_MACHINE {
247 const char * usri2_name;
248 const char * usri2_comment;
249 uint32_t usri2_flags;
250 uint32_t usri2_user_id;
251 uint32_t usri2_next_index;
254 struct NET_DISPLAY_GROUP {
255 const char * grpi3_name;
256 const char * grpi3_comment;
257 uint32_t grpi3_group_id;
258 uint32_t grpi3_attributes;
259 uint32_t grpi3_next_index;
262 struct GROUP_INFO_0 {
263 const char * grpi0_name;
266 struct GROUP_INFO_1 {
267 const char * grpi1_name;
268 const char * grpi1_comment;
271 struct GROUP_INFO_2 {
272 const char * grpi2_name;
273 const char * grpi2_comment;
274 uint32_t grpi2_group_id;
275 uint32_t grpi2_attributes;
278 struct GROUP_INFO_3 {
279 const char * grpi3_name;
280 const char * grpi3_comment;
281 struct domsid * grpi3_group_sid;
282 uint32_t grpi3_attributes;
285 struct GROUP_INFO_1002 {
286 const char * grpi1002_comment;
289 struct GROUP_INFO_1005 {
290 uint32_t grpi1005_attributes;
293 struct GROUP_USERS_INFO_0 {
294 const char * grui0_name;
297 struct GROUP_USERS_INFO_1 {
298 const char * grui1_name;
299 uint32_t grui1_attributes;
302 struct LOCALGROUP_INFO_0 {
303 const char * lgrpi0_name;
306 struct LOCALGROUP_INFO_1 {
307 const char * lgrpi1_name;
308 const char * lgrpi1_comment;
311 struct LOCALGROUP_INFO_1002 {
312 const char * lgrpi1002_comment;
315 struct TIME_OF_DAY_INFO {
316 uint32_t tod_elapsedt;
322 int32_t tod_timezone;
323 uint32_t tod_tinterval;
327 uint32_t tod_weekday;
330 #endif /* _HEADER_libnetapi */
332 /****************************************************************
333 ****************************************************************/
335 struct libnetapi_ctx {
343 int disable_policy_handle_cache;
348 /****************************************************************
349 ****************************************************************/
351 NET_API_STATUS libnetapi_init(struct libnetapi_ctx **ctx);
353 /****************************************************************
354 ****************************************************************/
356 NET_API_STATUS libnetapi_free(struct libnetapi_ctx *ctx);
358 /****************************************************************
359 ****************************************************************/
361 NET_API_STATUS libnetapi_getctx(struct libnetapi_ctx **ctx);
363 /****************************************************************
364 ****************************************************************/
366 NET_API_STATUS libnetapi_set_debuglevel(struct libnetapi_ctx *ctx,
367 const char *debuglevel);
369 /****************************************************************
370 ****************************************************************/
372 NET_API_STATUS libnetapi_set_username(struct libnetapi_ctx *ctx,
373 const char *username);
375 /****************************************************************
376 ****************************************************************/
378 NET_API_STATUS libnetapi_set_password(struct libnetapi_ctx *ctx,
379 const char *password);
381 /****************************************************************
382 ****************************************************************/
384 NET_API_STATUS libnetapi_set_workgroup(struct libnetapi_ctx *ctx,
385 const char *workgroup);
387 /****************************************************************
388 ****************************************************************/
390 NET_API_STATUS libnetapi_set_use_kerberos(struct libnetapi_ctx *ctx);
392 /****************************************************************
393 ****************************************************************/
395 const char *libnetapi_errstr(NET_API_STATUS status);
397 /****************************************************************
398 ****************************************************************/
400 const char *libnetapi_get_error_string(struct libnetapi_ctx *ctx,
401 NET_API_STATUS status);
404 /****************************************************************
406 ****************************************************************/
408 NET_API_STATUS NetApiBufferFree(void *buffer);
410 /************************************************************//**
412 * ConvertSidToStringSid
414 * @brief Convert a domain sid into a string
416 * @param[in] sid A pointer to a sid structure
417 * @param[in] sid_string A pointer that holds a pointer to a sid string. Caller
418 * needs to free with free(3)
420 ***************************************************************/
422 int ConvertSidToStringSid(const struct domsid *sid,
425 /************************************************************//**
429 * @brief Join a computer to a domain or workgroup
431 * @param[in] server The server name to connect to
432 * @param[in] domain The domain or workgroup to join
433 * @param[in] account_ou The organizational Unit to create the computer account
435 * @param[in] account The domain account used for joining a domain
436 * @param[in] password The domain account's password used for joining a domain
437 * @param[in] join_flags Bitmask field to define specific join features
438 * @return NET_API_STATUS
440 * example netdomjoin/netdomjoin.c
441 ***************************************************************/
443 NET_API_STATUS NetJoinDomain(const char * server /* [in] */,
444 const char * domain /* [in] [ref] */,
445 const char * account_ou /* [in] */,
446 const char * account /* [in] */,
447 const char * password /* [in] */,
448 uint32_t join_flags /* [in] */);
450 /************************************************************//**
454 * @brief Unjoin a computer from a domain or workgroup
456 * @param[in] server_name The server name to connect to
457 * @param[in] account The domain account used for unjoining a domain
458 * @param[in] password The domain account's password used for unjoining a domain
459 * @param[in] unjoin_flags Bitmask field to define specific unjoin features
460 * @return NET_API_STATUS
462 ***************************************************************/
464 NET_API_STATUS NetUnjoinDomain(const char * server_name /* [in] */,
465 const char * account /* [in] */,
466 const char * password /* [in] */,
467 uint32_t unjoin_flags /* [in] */);
469 /************************************************************//**
471 * NetGetJoinInformation
473 * @brief Unjoin a computer from a domain or workgroup
475 * @param[in] server_name The server name to connect to
476 * @param[out] name_buffer Returns the name of the workgroup or domain
477 * @param[out] name_type Returns the type of that name
478 * @return NET_API_STATUS
480 * example netdomjoin-gui/netdomjoin-gui.c
482 ***************************************************************/
484 NET_API_STATUS NetGetJoinInformation(const char * server_name /* [in] */,
485 const char * *name_buffer /* [out] [ref] */,
486 uint16_t *name_type /* [out] [ref] */);
488 /************************************************************//**
492 * @brief Query for the list of joinable organizational Units that can be used
495 * @param[in] server_name The server name to connect to
496 * @param[in] domain The AD domain to query
497 * @param[in] account The domain account used for the query
498 * @param[in] password The domain account's password used for the query
499 * @param[out] ou_count The number of ous returned
500 * @param[out] ous Returned string array containing the ous
501 * @return NET_API_STATUS
503 * example netdomjoin-gui/netdomjoin-gui.c
505 ***************************************************************/
507 NET_API_STATUS NetGetJoinableOUs(const char * server_name /* [in] */,
508 const char * domain /* [in] [ref] */,
509 const char * account /* [in] */,
510 const char * password /* [in] */,
511 uint32_t *ou_count /* [out] [ref] */,
512 const char * **ous /* [out] [ref] */);
514 /************************************************************//**
518 * @brief Get Information on a server
520 * @param[in] server_name The server name to connect to
521 * @param[in] level The level to define which information is requested
522 * @param[out] buffer The returned buffer carrying the SERVER_INFO structure
523 * @return NET_API_STATUS
525 ***************************************************************/
527 NET_API_STATUS NetServerGetInfo(const char * server_name /* [in] */,
528 uint32_t level /* [in] */,
529 uint8_t **buffer /* [out] [ref] */);
531 /************************************************************//**
535 * @brief Get Information on a server
537 * @param[in] server_name The server name to connect to
538 * @param[in] level The level to define which information is set
539 * @param[in] buffer The buffer carrying the SERVER_INFO structure
540 * @param[out] parm_error On failure returns the invalid SERVER_INFO member
541 * @return NET_API_STATUS
543 ***************************************************************/
545 NET_API_STATUS NetServerSetInfo(const char * server_name /* [in] */,
546 uint32_t level /* [in] */,
547 uint8_t *buffer /* [in] [ref] */,
548 uint32_t *parm_error /* [out] [ref] */);
550 /************************************************************//**
554 * @brief Query for the PDC for a given domain
556 * @param[in] server_name The server name to connect to
557 * @param[in] domain_name The name of the domain to lookup
558 * @param[out] buffer The name of the domain to lookup
559 * @return NET_API_STATUS
561 * example getdc/getdc.c
562 ***************************************************************/
564 NET_API_STATUS NetGetDCName(const char * server_name /* [in] */,
565 const char * domain_name /* [in] */,
566 uint8_t **buffer /* [out] [ref] */);
568 /************************************************************//**
572 * @brief Query for any DC for a given domain
574 * @param[in] server_name The server name to connect to
575 * @param[in] domain_name The name of the domain to lookup
576 * @param[out] buffer The name of the domain to lookup
577 * @return NET_API_STATUS
579 * example getdc/getdc.c
580 ***************************************************************/
582 NET_API_STATUS NetGetAnyDCName(const char * server_name /* [in] */,
583 const char * domain_name /* [in] */,
584 uint8_t **buffer /* [out] [ref] */);
587 /************************************************************//**
591 * @brief Lookup a DC for a given domain and return information structure
593 * @param[in] server_name The server name to connect to
594 * @param[in] domain_name The name of the domain to lookup (cannot be NULL)
595 * @param[in] domain_guid The GUID of the domain to lookup (optional)
596 * @param[in] site_name The name of the site the DC should reside in
597 * @param[in] flags A bitmask to request specific features supported by the DC
598 * @param[out] dc_info Pointer to a DOMAIN_CONTROLLER_INFO structure
599 * @return NET_API_STATUS
601 * example dsgetdc/dsgetdc.c
602 ***************************************************************/
604 NET_API_STATUS DsGetDcName(const char * server_name /* [in] [unique] */,
605 const char * domain_name /* [in] [ref] */,
606 struct GUID *domain_guid /* [in] [unique] */,
607 const char * site_name /* [in] [unique] */,
608 uint32_t flags /* [in] */,
609 struct DOMAIN_CONTROLLER_INFO **dc_info /* [out] [ref] */);
611 /************************************************************//**
615 * @brief Create a user on a given server
617 * @param[in] server_name The server name to connect to
618 * @param[in] level The level of the USER_INFO structure passed in (Currently
619 * only level 1 is supported)
620 * @param[in] buffer The buffer carrying the USER_INFO structure
621 * @param[out] parm_error In case of error returns the failing member of the
623 * @return NET_API_STATUS
625 * example user/user_add.c
626 ***************************************************************/
628 NET_API_STATUS NetUserAdd(const char * server_name /* [in] */,
629 uint32_t level /* [in] */,
630 uint8_t *buffer /* [in] [ref] */,
631 uint32_t *parm_error /* [out] [ref] */);
633 /************************************************************//**
637 * @brief Delete a user on a given server
639 * @param[in] server_name The server name to connect to
640 * @param[in] user_name The user account to delete
641 * @return NET_API_STATUS
643 * example user/user_del.c
644 ***************************************************************/
646 NET_API_STATUS NetUserDel(const char * server_name /* [in] */,
647 const char * user_name /* [in] */);
649 /************************************************************//**
653 * @brief Enumerate accounts on a server
655 * @param[in] server_name The server name to connect to
656 * @param[in] level The enumeration level used for the query (Currently only
657 * level 0 is supported)
658 * @param[in] filter The account flags filter used for the query
659 * @param[out] buffer The returned enumeration buffer
660 * @param[in] prefmaxlen The requested maximal buffer size
661 * @param[out] entries_read The number of returned entries
662 * @param[out] total_entries The number of total entries
663 * @param[in,out] resume_handle A handle passed in and returned for resuming
665 * @return NET_API_STATUS
667 * example user/user_enum.c
668 ***************************************************************/
670 NET_API_STATUS NetUserEnum(const char * server_name /* [in] */,
671 uint32_t level /* [in] */,
672 uint32_t filter /* [in] */,
673 uint8_t **buffer /* [out] [ref] */,
674 uint32_t prefmaxlen /* [in] */,
675 uint32_t *entries_read /* [out] [ref] */,
676 uint32_t *total_entries /* [out] [ref] */,
677 uint32_t *resume_handle /* [in,out] [ref] */);
679 /************************************************************//**
681 * NetUserChangePassword
683 * @brief Change the password for a user on a given server or in a given domain
685 * @param[in] domain_name The server or domain name to connect to
686 * @param[in] user_name The user account to change the password for
687 * @param[in] old_password The user account's old password
688 * @param[in] new_password The user account's new password
689 * @return NET_API_STATUS
691 * example user/user_chgpwd.c
692 ***************************************************************/
694 NET_API_STATUS NetUserChangePassword(const char * domain_name /* [in] */,
695 const char * user_name /* [in] */,
696 const char * old_password /* [in] */,
697 const char * new_password /* [in] */);
699 /************************************************************//**
703 * @brief Get User Information
705 * @param[in] server_name The server name to connect to
706 * @param[in] user_name The name of the user that is going to be queried
707 * @param[in] level The level defining the requested USER_INFO_X structure
708 * @param[out] buffer The buffer containing a USER_INFO_X structure
709 * @return NET_API_STATUS
711 * example user/user_getinfo.c
712 ***************************************************************/
714 NET_API_STATUS NetUserGetInfo(const char * server_name /* [in] */,
715 const char * user_name /* [in] */,
716 uint32_t level /* [in] */,
717 uint8_t **buffer /* [out] [ref] */);
719 /************************************************************//**
723 * @brief Set User Information
725 * @param[in] server_name The server name to connect to
726 * @param[in] user_name The name of the user that is going to be modified
727 * @param[in] level The level defining the requested USER_INFO_X structure
728 * @param[in] buf The buffer containing a USER_INFO_X structure
729 * @param[out] parm_err The returned parameter error number if any
730 * @return NET_API_STATUS
732 * example user/user_setinfo.c
733 ***************************************************************/
735 NET_API_STATUS NetUserSetInfo(const char * server_name /* [in] */,
736 const char * user_name /* [in] */,
737 uint32_t level /* [in] */,
738 uint8_t *buffer /* [in] [ref] */,
739 uint32_t *parm_err /* [out] [ref] */);
741 /************************************************************//**
743 * NetQueryDisplayInformation
745 * @brief Enumerate accounts on a server
747 * @param[in] server_name The server name to connect to
748 * @param[in] level The enumeration level used for the query
749 * @param[in] idx The index to start the the display enumeration at
750 * @param[in] entries_requested The number of entries requested
751 * @param[in] prefmaxlen The requested maximal buffer size
752 * @param[out] entries_read The number of returned entries
753 * @param[out] buffer The returned display information buffer
754 * @return NET_API_STATUS
756 * example user/user_dispinfo.c
757 ***************************************************************/
759 NET_API_STATUS NetQueryDisplayInformation(const char * server_name /* [in] [unique] */,
760 uint32_t level /* [in] */,
761 uint32_t idx /* [in] */,
762 uint32_t entries_requested /* [in] */,
763 uint32_t prefmaxlen /* [in] */,
764 uint32_t *entries_read /* [out] [ref] */,
765 void **buffer /* [out] [noprint,ref] */);
767 /************************************************************//**
771 * @brief Create Domain Group
773 * @param[in] server_name The server name to connect to
774 * @param[in] level The level used for the new group creation
775 * @param[in] buf The buffer containing the group structure
776 * @param[out] parm_err The returned parameter error number if any
777 * @return NET_API_STATUS
779 * example group/group_add.c
780 ***************************************************************/
782 NET_API_STATUS NetGroupAdd(const char * server_name /* [in] */,
783 uint32_t level /* [in] */,
784 uint8_t *buf /* [in] [ref] */,
785 uint32_t *parm_err /* [out] [ref] */);
787 /************************************************************//**
791 * @brief Delete Domain Group
793 * @param[in] server_name The server name to connect to
794 * @param[in] group_name The name of the group that is going to be deleted
795 * @return NET_API_STATUS
797 * example group/group_del.c
798 ***************************************************************/
800 NET_API_STATUS NetGroupDel(const char * server_name /* [in] */,
801 const char * group_name /* [in] */);
803 /************************************************************//**
807 * @brief Enumerate groups on a server
809 * @param[in] server_name The server name to connect to
810 * @param[in] level The enumeration level used for the query (Currently only
811 * level 0 is supported)
812 * @param[out] buffer The returned enumeration buffer
813 * @param[in] prefmaxlen The requested maximal buffer size
814 * @param[out] entries_read The number of returned entries
815 * @param[out] total_entries The number of total entries
816 * @param[in,out] resume_handle A handle passed in and returned for resuming
818 * @return NET_API_STATUS
820 * example group/group_enum.c
821 ***************************************************************/
823 NET_API_STATUS NetGroupEnum(const char * server_name /* [in] */,
824 uint32_t level /* [in] */,
825 uint8_t **buffer /* [out] [ref] */,
826 uint32_t prefmaxlen /* [in] */,
827 uint32_t *entries_read /* [out] [ref] */,
828 uint32_t *total_entries /* [out] [ref] */,
829 uint32_t *resume_handle /* [in,out] [ref] */);
831 /************************************************************//**
835 * @brief Set Domain Group Information
837 * @param[in] server_name The server name to connect to
838 * @param[in] group_name The name of the group that is going to be modified
839 * @param[in] level The level defining the structure type in buf
840 * @param[in] buf The buffer containing a GROUP_INFO_X structure
841 * @param[out] parm_err The returned parameter error number if any
842 * @return NET_API_STATUS
844 * example group/group_setinfo.c
845 ***************************************************************/
847 NET_API_STATUS NetGroupSetInfo(const char * server_name /* [in] */,
848 const char * group_name /* [in] */,
849 uint32_t level /* [in] */,
850 uint8_t *buf /* [in] [ref] */,
851 uint32_t *parm_err /* [out] [ref] */);
853 /************************************************************//**
857 * @brief Get Domain Group Information
859 * @param[in] server_name The server name to connect to
860 * @param[in] group_name The name of the group that is going to be queried
861 * @param[in] level The level defining the requested GROUP_INFO_X structure
862 * @param[out] buf The buffer containing a GROUP_INFO_X structure
863 * @return NET_API_STATUS
865 * example group/group_getinfo.c
866 ***************************************************************/
868 NET_API_STATUS NetGroupGetInfo(const char * server_name /* [in] */,
869 const char * group_name /* [in] */,
870 uint32_t level /* [in] */,
871 uint8_t **buf /* [out] [ref] */);
873 /************************************************************//**
877 * @brief Add existing User to existing Domain Group
879 * @param[in] server_name The server name to connect to
880 * @param[in] group_name The name of the group that is going to be modified
881 * @param[in] user_name The name of the user that is going to be added to the
883 * @return NET_API_STATUS
885 * example group/group_adduser.c
886 ***************************************************************/
888 NET_API_STATUS NetGroupAddUser(const char * server_name /* [in] */,
889 const char * group_name /* [in] */,
890 const char * user_name /* [in] */);
892 /************************************************************//**
896 * @brief Remove User from Domain Group
898 * @param[in] server_name The server name to connect to
899 * @param[in] group_name The name of the group that is going to be modified
900 * @param[in] user_name The name of the user that is going to be removed from
902 * @return NET_API_STATUS
904 * example group/group_deluser.c
905 ***************************************************************/
907 NET_API_STATUS NetGroupDelUser(const char * server_name /* [in] */,
908 const char * group_name /* [in] */,
909 const char * user_name /* [in] */);
911 /************************************************************//**
915 * @brief Get Users for a group on a server
917 * @param[in] server_name The server name to connect to
918 * @param[in] group_name The group name to enumerate users for
919 * @param[in] level The enumeration level used for the query
920 * @param[out] buffer The returned enumeration buffer
921 * @param[in] prefmaxlen The requested maximal buffer size
922 * @param[out] entries_read The number of returned entries
923 * @param[out] total_entries The number of total entries
924 * @param[in,out] resume_handle A handle passed in and returned for resuming
926 * @return NET_API_STATUS
928 * example group/group_getusers.c
929 ***************************************************************/
931 NET_API_STATUS NetGroupGetUsers(const char * server_name /* [in] */,
932 const char * group_name /* [in] */,
933 uint32_t level /* [in] */,
934 uint8_t **buffer /* [out] [ref] */,
935 uint32_t prefmaxlen /* [in] */,
936 uint32_t *entries_read /* [out] [ref] */,
937 uint32_t *total_entries /* [out] [ref] */,
938 uint32_t *resume_handle /* [in,out] [ref] */);
940 /************************************************************//**
944 * @brief Create Local Group
946 * @param[in] server_name The server name to connect to
947 * @param[in] level The level used for the new group creation
948 * @param[in] buf The buffer containing the group structure
949 * @param[out] parm_err The returned parameter error number if any
950 * @return NET_API_STATUS
952 * example localgroup/localgroup_add.c
953 ***************************************************************/
955 NET_API_STATUS NetLocalGroupAdd(const char * server_name /* [in] */,
956 uint32_t level /* [in] */,
957 uint8_t *buf /* [in] [ref] */,
958 uint32_t *parm_err /* [out] [ref] */);
960 /************************************************************//**
964 * @brief Delete Local Group
966 * @param[in] server_name The server name to connect to
967 * @param[in] group_name The name of the group that is going to be deleted
968 * @return NET_API_STATUS
970 * example localgroup/localgroup_del.c
971 ***************************************************************/
974 NET_API_STATUS NetLocalGroupDel(const char * server_name /* [in] */,
975 const char * group_name /* [in] */);
977 /************************************************************//**
979 * NetLocalGroupGetInfo
981 * @brief Get Local Group Information
983 * @param[in] server_name The server name to connect to
984 * @param[in] group_name The name of the group that is going to be queried
985 * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
986 * @param[out] buf The buffer containing a LOCALGROUP_INFO_X structure
987 * @return NET_API_STATUS
989 * example localgroup/localgroup_getinfo.c
990 ***************************************************************/
992 NET_API_STATUS NetLocalGroupGetInfo(const char * server_name /* [in] */,
993 const char * group_name /* [in] */,
994 uint32_t level /* [in] */,
995 uint8_t **buf /* [out] [ref] */);
997 /************************************************************//**
999 * NetLocalGroupSetInfo
1001 * @brief Set Local Group Information
1003 * @param[in] server_name The server name to connect to
1004 * @param[in] group_name The name of the group that is going to be modified
1005 * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
1006 * @param[in] buf The buffer containing a LOCALGROUP_INFO_X structure
1007 * @param[out] parm_err The returned parameter error number if any
1008 * @return NET_API_STATUS
1010 * example localgroup/localgroup_setinfo.c
1011 ***************************************************************/
1014 NET_API_STATUS NetLocalGroupSetInfo(const char * server_name /* [in] */,
1015 const char * group_name /* [in] */,
1016 uint32_t level /* [in] */,
1017 uint8_t *buf /* [in] [ref] */,
1018 uint32_t *parm_err /* [out] [ref] */);
1020 /************************************************************//**
1024 * @brief Enumerate local groups on a server
1026 * @param[in] server_name The server name to connect to
1027 * @param[in] level The enumeration level used for the query (Currently only
1028 * level 0 is supported)
1029 * @param[out] buffer The returned enumeration buffer
1030 * @param[in] prefmaxlen The requested maximal buffer size
1031 * @param[out] entries_read The number of returned entries
1032 * @param[out] total_entries The number of total entries
1033 * @param[in,out] resume_handle A handle passed in and returned for resuming
1035 * @return NET_API_STATUS
1037 * example localgroup/localgroup_enum.c
1038 ***************************************************************/
1040 NET_API_STATUS NetLocalGroupEnum(const char * server_name /* [in] */,
1041 uint32_t level /* [in] */,
1042 uint8_t **buffer /* [out] [ref] */,
1043 uint32_t prefmaxlen /* [in] */,
1044 uint32_t *entries_read /* [out] [ref] */,
1045 uint32_t *total_entries /* [out] [ref] */,
1046 uint32_t *resume_handle /* [in,out] [ref] */);
1048 /************************************************************//**
1052 * @brief Query remote Time of Day
1054 * @param[in] server_name The server name to connect to
1055 * @param[out] buf The buffer containing a TIME_OF_DAY_INFO structure
1056 * @return NET_API_STATUS
1058 * example server/remote_tod.c
1059 ***************************************************************/
1061 NET_API_STATUS NetRemoteTOD(const char * server_name /* [in] */,
1062 uint8_t **buf /* [out] [ref] */);