source3/lib/netapi/netapi.h

   1 /*
   2  *  Unix SMB/CIFS implementation.
   3  *  NetApi Support
   4  *  Copyright (C) Guenther Deschner 2007-2008
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; either version 3 of the License, or
   9  *  (at your option) any later version.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #ifndef __LIB_NETAPI_H__
  21 #define __LIB_NETAPI_H__
  22
  23 /****************************************************************
  24  NET_API_STATUS
  25 ****************************************************************/
  26 typedef enum {
  27         NET_API_STATUS_SUCCESS = 0
  28 } NET_API_STATUS;
  29
  30 #define ERROR_MORE_DATA ( 234L )
  31
  32 /****************************************************************
  33 ****************************************************************/
  34
  35 #ifndef _HEADER_misc
  36
  37 struct GUID {
  38         uint32_t time_low;
  39         uint16_t time_mid;
  40         uint16_t time_hi_and_version;
  41         uint8_t clock_seq[2];
  42         uint8_t node[6];
  43 };
  44
  45 #endif /* _HEADER_misc */
  46
  47 #ifndef _HEADER_libnetapi
  48
  49 #ifndef MAXSUBAUTHS
  50 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
  51 #endif
  52
  53 struct domsid {
  54         uint8_t   sid_rev_num;
  55         uint8_t   num_auths;
  56         uint8_t   id_auth[6];
  57         uint32_t  sub_auths[MAXSUBAUTHS];
  58 };
  59
  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;
  67         uint32_t flags;
  68         const char * dc_site_name;
  69         const char * client_site_name;
  70 };
  71
  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 )
  77
  78 struct SERVER_INFO_1005 {
  79         const char * sv1005_comment;
  80 };
  81
  82 struct USER_INFO_0 {
  83         const char * usri0_name;
  84 };
  85
  86 struct USER_INFO_1 {
  87         const char * usri1_name;
  88         const char * usri1_password;
  89         uint32_t usri1_password_age;
  90         uint32_t usri1_priv;
  91         const char * usri1_home_dir;
  92         const char * usri1_comment;
  93         uint32_t usri1_flags;
  94         const char * usri1_script_path;
  95 };
  96
  97 struct NET_DISPLAY_USER {
  98         const char * usri1_name;
  99         const char * usri1_comment;
 100         uint32_t usri1_flags;
 101         const char * usri1_full_name;
 102         uint32_t usri1_user_id;
 103         uint32_t usri1_next_index;
 104 };
 105
 106 struct NET_DISPLAY_MACHINE {
 107         const char * usri2_name;
 108         const char * usri2_comment;
 109         uint32_t usri2_flags;
 110         uint32_t usri2_user_id;
 111         uint32_t usri2_next_index;
 112 };
 113
 114 struct NET_DISPLAY_GROUP {
 115         const char * grpi3_name;
 116         const char * grpi3_comment;
 117         uint32_t grpi3_group_id;
 118         uint32_t grpi3_attributes;
 119         uint32_t grpi3_next_index;
 120 };
 121
 122 struct GROUP_INFO_0 {
 123         const char * grpi0_name;
 124 };
 125
 126 struct GROUP_INFO_1 {
 127         const char * grpi1_name;
 128         const char * grpi1_comment;
 129 };
 130
 131 struct GROUP_INFO_2 {
 132         const char * grpi2_name;
 133         const char * grpi2_comment;
 134         uint32_t grpi2_group_id;
 135         uint32_t grpi2_attributes;
 136 };
 137
 138 struct GROUP_INFO_3 {
 139         const char * grpi3_name;
 140         const char * grpi3_comment;
 141         struct domsid grpi3_group_sid;
 142         uint32_t grpi3_attributes;
 143 };
 144
 145 struct GROUP_INFO_1002 {
 146         const char * grpi1002_comment;
 147 };
 148
 149 struct GROUP_INFO_1005 {
 150         uint32_t grpi1005_attributes;
 151 };
 152
 153 struct LOCALGROUP_INFO_0 {
 154         const char * lgrpi0_name;
 155 };
 156
 157 struct LOCALGROUP_INFO_1 {
 158         const char * lgrpi1_name;
 159         const char * lgrpi1_comment;
 160 };
 161
 162 struct LOCALGROUP_INFO_1002 {
 163         const char * lgrpi1002_comment;
 164 };
 165
 166 struct TIME_OF_DAY_INFO {
 167         uint32_t tod_elapsedt;
 168         uint32_t tod_msecs;
 169         uint32_t tod_hours;
 170         uint32_t tod_mins;
 171         uint32_t tod_secs;
 172         uint32_t tod_hunds;
 173         int32_t tod_timezone;
 174         uint32_t tod_tinterval;
 175         uint32_t tod_day;
 176         uint32_t tod_month;
 177         uint32_t tod_year;
 178         uint32_t tod_weekday;
 179 };
 180
 181 #endif /* _HEADER_libnetapi */
 182
 183 /****************************************************************
 184 ****************************************************************/
 185
 186 struct libnetapi_ctx {
 187         char *debuglevel;
 188         char *error_string;
 189         char *username;
 190         char *workgroup;
 191         char *password;
 192         char *krb5_cc_env;
 193         int use_kerberos;
 194 };
 195
 196 /****************************************************************
 197 ****************************************************************/
 198
 199 NET_API_STATUS libnetapi_init(struct libnetapi_ctx **ctx);
 200
 201 /****************************************************************
 202 ****************************************************************/
 203
 204 NET_API_STATUS libnetapi_free(struct libnetapi_ctx *ctx);
 205
 206 /****************************************************************
 207 ****************************************************************/
 208
 209 NET_API_STATUS libnetapi_getctx(struct libnetapi_ctx **ctx);
 210
 211 /****************************************************************
 212 ****************************************************************/
 213
 214 NET_API_STATUS libnetapi_set_debuglevel(struct libnetapi_ctx *ctx,
 215                                         const char *debuglevel);
 216
 217 /****************************************************************
 218 ****************************************************************/
 219
 220 NET_API_STATUS libnetapi_set_username(struct libnetapi_ctx *ctx,
 221                                       const char *username);
 222
 223 /****************************************************************
 224 ****************************************************************/
 225
 226 NET_API_STATUS libnetapi_set_password(struct libnetapi_ctx *ctx,
 227                                       const char *password);
 228
 229 /****************************************************************
 230 ****************************************************************/
 231
 232 NET_API_STATUS libnetapi_set_workgroup(struct libnetapi_ctx *ctx,
 233                                        const char *workgroup);
 234
 235 /****************************************************************
 236 ****************************************************************/
 237
 238 NET_API_STATUS libnetapi_set_use_kerberos(struct libnetapi_ctx *ctx);
 239
 240 /****************************************************************
 241 ****************************************************************/
 242
 243 const char *libnetapi_errstr(NET_API_STATUS status);
 244
 245 /****************************************************************
 246 ****************************************************************/
 247
 248 const char *libnetapi_get_error_string(struct libnetapi_ctx *ctx,
 249                                        NET_API_STATUS status);
 250
 251
 252 /****************************************************************
 253  NetApiBufferFree
 254 ****************************************************************/
 255
 256 NET_API_STATUS NetApiBufferFree(void *buffer);
 257
 258 /************************************************************//**
 259  *
 260  * NetJoinDomain
 261  *
 262  * @brief Join a computer to a domain or workgroup
 263  *
 264  * @param[in] server The server name to connect to
 265  * @param[in] domain The domain or workgroup to join
 266  * @param[in] account_ou The organizational Unit to create the computer account
 267  * in (AD only)
 268  * @param[in] account The domain account used for joining a domain
 269  * @param[in] password The domain account's password used for joining a domain
 270  * @param[in] join_flags Bitmask field to define specific join features
 271  * @return NET_API_STATUS
 272  *
 273  * example netdomjoin/netdomjoin.c
 274  ***************************************************************/
 275
 276 NET_API_STATUS NetJoinDomain(const char * server /* [in] */,
 277                              const char * domain /* [in] [ref] */,
 278                              const char * account_ou /* [in] */,
 279                              const char * account /* [in] */,
 280                              const char * password /* [in] */,
 281                              uint32_t join_flags /* [in] */);
 282
 283 /************************************************************//**
 284  *
 285  * NetUnjoinDomain
 286  *
 287  * @brief Unjoin a computer from a domain or workgroup
 288  *
 289  * @param[in] server_name The server name to connect to
 290  * @param[in] account The domain account used for unjoining a domain
 291  * @param[in] password The domain account's password used for unjoining a domain
 292  * @param[in] unjoin_flags Bitmask field to define specific unjoin features
 293  * @return NET_API_STATUS
 294  *
 295  ***************************************************************/
 296
 297 NET_API_STATUS NetUnjoinDomain(const char * server_name /* [in] */,
 298                                const char * account /* [in] */,
 299                                const char * password /* [in] */,
 300                                uint32_t unjoin_flags /* [in] */);
 301
 302 /************************************************************//**
 303  *
 304  * NetGetJoinInformation
 305  *
 306  * @brief Unjoin a computer from a domain or workgroup
 307  *
 308  * @param[in] server_name The server name to connect to
 309  * @param[out] name_buffer Returns the name of the workgroup or domain
 310  * @param[out] name_type  Returns the type of that name
 311  * @return NET_API_STATUS
 312  *
 313  * example netdomjoin-gui/netdomjoin-gui.c
 314  *
 315  ***************************************************************/
 316
 317 NET_API_STATUS NetGetJoinInformation(const char * server_name /* [in] */,
 318                                      const char * *name_buffer /* [out] [ref] */,
 319                                      uint16_t *name_type /* [out] [ref] */);
 320
 321 /************************************************************//**
 322  *
 323  * NetGetJoinableOUs
 324  *
 325  * @brief Query for the list of joinable organizational Units that can be used
 326  * for joining AD
 327  *
 328  * @param[in] server_name The server name to connect to
 329  * @param[in] domain The AD domain to query
 330  * @param[in] account The domain account used for the query
 331  * @param[in] password The domain account's password used for the query
 332  * @param[out] ou_count The number of ous returned
 333  * @param[out] ous Returned string array containing the ous
 334  * @return NET_API_STATUS
 335  *
 336  * example netdomjoin-gui/netdomjoin-gui.c
 337  *
 338  ***************************************************************/
 339
 340 NET_API_STATUS NetGetJoinableOUs(const char * server_name /* [in] */,
 341                                  const char * domain /* [in] [ref] */,
 342                                  const char * account /* [in] */,
 343                                  const char * password /* [in] */,
 344                                  uint32_t *ou_count /* [out] [ref] */,
 345                                  const char * **ous /* [out] [ref] */);
 346
 347 /************************************************************//**
 348  *
 349  * NetServerGetInfo
 350  *
 351  * @brief Get Information on a server
 352  *
 353  * @param[in] server_name The server name to connect to
 354  * @param[in] level The level to define which information is requested
 355  * @param[out] buffer The returned buffer carrying the SERVER_INFO structure
 356  * @return NET_API_STATUS
 357  *
 358  ***************************************************************/
 359
 360 NET_API_STATUS NetServerGetInfo(const char * server_name /* [in] */,
 361                                 uint32_t level /* [in] */,
 362                                 uint8_t **buffer /* [out] [ref] */);
 363
 364 /************************************************************//**
 365  *
 366  * NetServerSetInfo
 367  *
 368  * @brief Get Information on a server
 369  *
 370  * @param[in] server_name The server name to connect to
 371  * @param[in] level The level to define which information is set
 372  * @param[in] buffer The buffer carrying the SERVER_INFO structure
 373  * @param[out] parm_error On failure returns the invalid SERVER_INFO member
 374  * @return NET_API_STATUS
 375  *
 376  ***************************************************************/
 377
 378 NET_API_STATUS NetServerSetInfo(const char * server_name /* [in] */,
 379                                 uint32_t level /* [in] */,
 380                                 uint8_t *buffer /* [in] [ref] */,
 381                                 uint32_t *parm_error /* [out] [ref] */);
 382
 383 /************************************************************//**
 384  *
 385  * NetGetDCName
 386  *
 387  * @brief Query for the PDC for a given domain
 388  *
 389  * @param[in] server_name The server name to connect to
 390  * @param[in] domain_name The name of the domain to lookup
 391  * @param[out] buffer The name of the domain to lookup
 392  * @return NET_API_STATUS
 393  *
 394  * example getdc/getdc.c
 395  ***************************************************************/
 396
 397 NET_API_STATUS NetGetDCName(const char * server_name /* [in] */,
 398                             const char * domain_name /* [in] */,
 399                             uint8_t **buffer /* [out] [ref] */);
 400
 401 /************************************************************//**
 402  *
 403  * NetGetAnyDCName
 404  *
 405  * @brief Query for any DC for a given domain
 406  *
 407  * @param[in] server_name The server name to connect to
 408  * @param[in] domain_name The name of the domain to lookup
 409  * @param[out] buffer The name of the domain to lookup
 410  * @return NET_API_STATUS
 411  *
 412  * example getdc/getdc.c
 413  ***************************************************************/
 414
 415 NET_API_STATUS NetGetAnyDCName(const char * server_name /* [in] */,
 416                                const char * domain_name /* [in] */,
 417                                uint8_t **buffer /* [out] [ref] */);
 418
 419
 420 /************************************************************//**
 421  *
 422  * DsGetDcName
 423  *
 424  * @brief Lookup a DC for a given domain and return information structure
 425  *
 426  * @param[in] server_name The server name to connect to
 427  * @param[in] domain_name The name of the domain to lookup (cannot be NULL)
 428  * @param[in] domain_guid The GUID of the domain to lookup (optional)
 429  * @param[in] site_name The name of the site the DC should reside in
 430  * @param[in] flags A bitmask to request specific features supported by the DC
 431  * @param[out] dc_info Pointer to a DOMAIN_CONTROLLER_INFO structure
 432  * @return NET_API_STATUS
 433  *
 434  * example dsgetdc/dsgetdc.c
 435  ***************************************************************/
 436
 437 NET_API_STATUS DsGetDcName(const char * server_name /* [in] [unique] */,
 438                            const char * domain_name /* [in] [ref] */,
 439                            struct GUID *domain_guid /* [in] [unique] */,
 440                            const char * site_name /* [in] [unique] */,
 441                            uint32_t flags /* [in] */,
 442                            struct DOMAIN_CONTROLLER_INFO **dc_info /* [out] [ref] */);
 443
 444 /************************************************************//**
 445  *
 446  * NetUserAdd
 447  *
 448  * @brief Create a user on a given server
 449  *
 450  * @param[in] server_name The server name to connect to
 451  * @param[in] level The level of the USER_INFO structure passed in (Currently
 452  * only level 1 is supported)
 453  * @param[in] buffer The buffer carrying the USER_INFO structure
 454  * @param[out] parm_error In case of error returns the failing member of the
 455  * structure
 456  * @return NET_API_STATUS
 457  *
 458  * example user/user_add.c
 459  ***************************************************************/
 460
 461 NET_API_STATUS NetUserAdd(const char * server_name /* [in] */,
 462                           uint32_t level /* [in] */,
 463                           uint8_t *buffer /* [in] [ref] */,
 464                           uint32_t *parm_error /* [out] [ref] */);
 465
 466 /************************************************************//**
 467  *
 468  * NetUserDel
 469  *
 470  * @brief Delete a user on a given server
 471  *
 472  * @param[in] server_name The server name to connect to
 473  * @param[in] user_name The user account to delete
 474  * @return NET_API_STATUS
 475  *
 476  * example user/user_del.c
 477  ***************************************************************/
 478
 479 NET_API_STATUS NetUserDel(const char * server_name /* [in] */,
 480                           const char * user_name /* [in] */);
 481
 482 /************************************************************//**
 483  *
 484  * NetUserEnum
 485  *
 486  * @brief Enumerate accounts on a server
 487  *
 488  * @param[in] server_name The server name to connect to
 489  * @param[in] level The enumeration level used for the query (Currently only
 490  * level 0 is supported)
 491  * @param[in] filter The account flags filter used for the query
 492  * @param[out] buffer The returned enumeration buffer
 493  * @param[in] prefmaxlen The requested maximal buffer size
 494  * @param[out] entries_read The number of returned entries
 495  * @param[out] total_entries The number of total entries
 496  * @param[in,out] resume_handle A handle passed in and returned for resuming
 497  * operations
 498  * @return NET_API_STATUS
 499  *
 500  * example user/user_enum.c
 501  ***************************************************************/
 502
 503 NET_API_STATUS NetUserEnum(const char * server_name /* [in] */,
 504                            uint32_t level /* [in] */,
 505                            uint32_t filter /* [in] */,
 506                            uint8_t **buffer /* [out] [ref] */,
 507                            uint32_t prefmaxlen /* [in] */,
 508                            uint32_t *entries_read /* [out] [ref] */,
 509                            uint32_t *total_entries /* [out] [ref] */,
 510                            uint32_t *resume_handle /* [in,out] [ref] */);
 511
 512 /************************************************************//**
 513  *
 514  * NetUserChangePassword
 515  *
 516  * @brief Change the password for a user on a given server or in a given domain
 517  *
 518  * @param[in] domain_name The server or domain name to connect to
 519  * @param[in] user_name The user account to change the password for
 520  * @param[in] old_password The user account's old password
 521  * @param[in] old_password The user account's new password
 522  * @return NET_API_STATUS
 523  *
 524  * example user/user_chgpwd.c
 525  ***************************************************************/
 526
 527 NET_API_STATUS NetUserChangePassword(const char * domain_name /* [in] */,
 528                                      const char * user_name /* [in] */,
 529                                      const char * old_password /* [in] */,
 530                                      const char * new_password /* [in] */);
 531
 532 /************************************************************//**
 533  *
 534  * NetQueryDisplayInformation
 535  *
 536  * @brief Enumerate accounts on a server
 537  *
 538  * @param[in] server_name The server name to connect to
 539  * @param[in] level The enumeration level used for the query
 540  * @param[in] idx The index to start the the display enumeration at
 541  * @param[in] entries_requested The number of entries requested
 542  * @param[in] prefmaxlen The requested maximal buffer size
 543  * @param[out] entries_read The number of returned entries
 544  * @param[out] buffer The returned display information buffer
 545  * @return NET_API_STATUS
 546  *
 547  * example user/user_dispinfo.c
 548  ***************************************************************/
 549
 550 NET_API_STATUS NetQueryDisplayInformation(const char * server_name /* [in] [unique] */,
 551                                           uint32_t level /* [in] */,
 552                                           uint32_t idx /* [in] */,
 553                                           uint32_t entries_requested /* [in] */,
 554                                           uint32_t prefmaxlen /* [in] */,
 555                                           uint32_t *entries_read /* [out] [ref] */,
 556                                           void **buffer /* [out] [noprint,ref] */);
 557
 558 /************************************************************//**
 559  *
 560  * NetGroupAdd
 561  *
 562  * @brief Create Domain Group
 563  *
 564  * @param[in] server_name The server name to connect to
 565  * @param[in] level The level used for the new group creation
 566  * @param[in] buf The buffer containing the group structure
 567  * @param[out] parm_err The returned parameter error number if any
 568  * @return NET_API_STATUS
 569  *
 570  * example group/group_add.c
 571  ***************************************************************/
 572
 573 NET_API_STATUS NetGroupAdd(const char * server_name /* [in] */,
 574                            uint32_t level /* [in] */,
 575                            uint8_t *buf /* [in] [ref] */,
 576                            uint32_t *parm_err /* [out] [ref] */);
 577
 578 /************************************************************//**
 579  *
 580  * NetGroupDel
 581  *
 582  * @brief Delete Domain Group
 583  *
 584  * @param[in] server_name The server name to connect to
 585  * @param[in] group_name The name of the group that is going to be deleted
 586  * @return NET_API_STATUS
 587  *
 588  * example group/group_del.c
 589  ***************************************************************/
 590
 591 NET_API_STATUS NetGroupDel(const char * server_name /* [in] */,
 592                            const char * group_name /* [in] */);
 593
 594 /************************************************************//**
 595  *
 596  * NetGroupSetInfo
 597  *
 598  * @brief Set Domain Group Information
 599  *
 600  * @param[in] server_name The server name to connect to
 601  * @param[in] group_name The name of the group that is going to be modified
 602  * @param[in] level The level defining the structure type in buf
 603  * @param[in] buf The buffer containing a GROUP_INFO_X structure
 604  * @param[out] parm_err The returned parameter error number if any
 605  * @return NET_API_STATUS
 606  *
 607  * example group/group_setinfo.c
 608  ***************************************************************/
 609
 610 NET_API_STATUS NetGroupSetInfo(const char * server_name /* [in] */,
 611                                const char * group_name /* [in] */,
 612                                uint32_t level /* [in] */,
 613                                uint8_t *buf /* [in] [ref] */,
 614                                uint32_t *parm_err /* [out] [ref] */);
 615
 616 /************************************************************//**
 617  *
 618  * NetGroupGetInfo
 619  *
 620  * @brief Get Domain Group Information
 621  *
 622  * @param[in] server_name The server name to connect to
 623  * @param[in] group_name The name of the group that is going to be modified
 624  * @param[in] level The level defining the requested GROUP_INFO_X structure
 625  * @param[out] buf The buffer containing a GROUP_INFO_X structure
 626  * @return NET_API_STATUS
 627  *
 628  * example group/group_del.c
 629  ***************************************************************/
 630
 631 NET_API_STATUS NetGroupGetInfo(const char * server_name /* [in] */,
 632                                const char * group_name /* [in] */,
 633                                uint32_t level /* [in] */,
 634                                uint8_t **buf /* [out] [ref] */);
 635
 636 /************************************************************//**
 637  *
 638  * NetGroupAddUser
 639  *
 640  * @brief Add existing User to existing Domain Group
 641  *
 642  * @param[in] server_name The server name to connect to
 643  * @param[in] group_name The name of the group that is going to be modified
 644  * @param[in] user_name The name of the user that is going to be added to the
 645  * group
 646  * @return NET_API_STATUS
 647  *
 648  * example group/group_adduser.c
 649  ***************************************************************/
 650
 651 NET_API_STATUS NetGroupAddUser(const char * server_name /* [in] */,
 652                                const char * group_name /* [in] */,
 653                                const char * user_name /* [in] */);
 654
 655 /************************************************************//**
 656  *
 657  * NetGroupDelUser
 658  *
 659  * @brief Remove User from Domain Group
 660  *
 661  * @param[in] server_name The server name to connect to
 662  * @param[in] group_name The name of the group that is going to be modified
 663  * @param[in] user_name The name of the user that is going to be removed from
 664  * the group
 665  * @return NET_API_STATUS
 666  *
 667  * example group/group_deluser.c
 668  ***************************************************************/
 669
 670 NET_API_STATUS NetGroupDelUser(const char * server_name /* [in] */,
 671                                const char * group_name /* [in] */,
 672                                const char * user_name /* [in] */);
 673
 674 /************************************************************//**
 675  *
 676  * NetLocalGroupAdd
 677  *
 678  * @brief Create Local Group
 679  *
 680  * @param[in] server_name The server name to connect to
 681  * @param[in] level The level used for the new group creation
 682  * @param[in] buf The buffer containing the group structure
 683  * @param[out] parm_err The returned parameter error number if any
 684  * @return NET_API_STATUS
 685  *
 686  * example localgroup/localgroup_add.c
 687  ***************************************************************/
 688
 689 NET_API_STATUS NetLocalGroupAdd(const char * server_name /* [in] */,
 690                                 uint32_t level /* [in] */,
 691                                 uint8_t *buf /* [in] [ref] */,
 692                                 uint32_t *parm_err /* [out] [ref] */);
 693
 694 /************************************************************//**
 695  *
 696  * NetLocalGroupDel
 697  *
 698  * @brief Delete Local Group
 699  *
 700  * @param[in] server_name The server name to connect to
 701  * @param[in] group_name The name of the group that is going to be deleted
 702  * @return NET_API_STATUS
 703  *
 704  * example localgroup/localgroup_del.c
 705  ***************************************************************/
 706
 707
 708 NET_API_STATUS NetLocalGroupDel(const char * server_name /* [in] */,
 709                                 const char * group_name /* [in] */);
 710
 711 /************************************************************//**
 712  *
 713  * NetLocalGroupGetInfo
 714  *
 715  * @brief Get Local Group Information
 716  *
 717  * @param[in] server_name The server name to connect to
 718  * @param[in] group_name The name of the group that is going to be queried
 719  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
 720  * @param[out] buf The buffer containing a LOCALGROUP_INFO_X structure
 721  * @return NET_API_STATUS
 722  *
 723  * example localgroup/localgroup_getinfo.c
 724  ***************************************************************/
 725
 726 NET_API_STATUS NetLocalGroupGetInfo(const char * server_name /* [in] */,
 727                                     const char * group_name /* [in] */,
 728                                     uint32_t level /* [in] */,
 729                                     uint8_t **buf /* [out] [ref] */);
 730
 731 /************************************************************//**
 732  *
 733  * NetLocalGroupSetInfo
 734  *
 735  * @brief Set Local Group Information
 736  *
 737  * @param[in] server_name The server name to connect to
 738  * @param[in] group_name The name of the group that is going to be modified
 739  * @param[in] level The level defining the requested LOCALGROUP_INFO_X structure
 740  * @param[in] buf The buffer containing a LOCALGROUP_INFO_X structure
 741  * @param[out] parm_err The returned parameter error number if any
 742  * @return NET_API_STATUS
 743  *
 744  * example localgroup/localgroup_setinfo.c
 745  ***************************************************************/
 746
 747
 748 NET_API_STATUS NetLocalGroupSetInfo(const char * server_name /* [in] */,
 749                                     const char * group_name /* [in] */,
 750                                     uint32_t level /* [in] */,
 751                                     uint8_t *buf /* [in] [ref] */,
 752                                     uint32_t *parm_err /* [out] [ref] */);
 753
 754 /************************************************************//**
 755  *
 756  * NetRemoteTOD
 757  *
 758  * @brief Query remote Time of Day
 759  *
 760  * @param[in] server_name The server name to connect to
 761  * @param[out] buf The buffer containing a TIME_OF_DAY_INFO structure
 762  * @return NET_API_STATUS
 763  *
 764  * example server/remote_tod.c
 765  ***************************************************************/
 766
 767 NET_API_STATUS NetRemoteTOD(const char * server_name /* [in] */,
 768                             uint8_t **buf /* [out] [ref] */);
 769
 770 #endif