The NetGroupAdd API creates a new group account in the user accounts subsystem (UAS) database in LAN Server and OS/2 Warp Server.

Restrictions

LAN Server and OS/2 Warp Server Only

This API can be called from DLS and OS/2 workstations, but only DLS workstations can issue this call to a remote LAN Server workstation. DLS workstations can issue this call locally only if the Peer service is started. Administrator authority is required to call this API.

Directory and Security Server Only

Groups are created in the Security Server database rather than in the NET.ACC file. User authority is based on ACLs, not privilege level.

In DSS, users and groups may have the same name.

Syntax

#include <netcons.h>
#include <access.h>
#include <lsdceerr.h>           /* DSS only */
 
NetGroupAdd(pszTarget, usLevel,
              buf, usBuflen);                         /* 16 bit */
 
Net32GroupAdd(pszTarget ulLevel,
              buf, ulBuflen, pStatusbuf);        /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

pszTarget

The following describe the effects of using different forms of using pszTarget

null or \\servername

group added to cell and server's resource domain
/.: or / ... /cellname
adds group to a cell
//resdomname
group added to cell and resource domain
sLevel or ulLevel
(16-bit short or 32-bit unsigned long) can be 0 or 1, specifying which level of data structure to use, as described in Group Information Level 0 and Group Information Level 1.

Note: When a group is added at level 0, the data structure comment field is set to an empty string, since a comment field is not provided in the level 0 structure.

Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДїіSYMBOLICCONSTANT іVALUEіMEANING і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_Success і 0 і No errors were encountered. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_ACCESS_DENIED і 5 і Administrator privilege is required. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_NOT_ENOUGH_MEMORY і 8 і Sufficient memory is not available. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_NOT_SUPPORTED і 50 і This request is not supported by the і
і і і network. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_BAD_NETPATH і 53 і The network path cannot be found. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_NETWORK_ACCESS_DENIED і 65 і Network access is denied. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і ERROR_INVALID_LEVEL і 124 і The ul/usLevel parameter is not valid. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_RemoteOnly і 2106 і This operation is not supported on і
і і і workstations. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_BufTooSmall і 2123 і The buffer is too small for fixed- і
і і і length data. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_WkstaNotStarted і 2138 і The Requester service has not been і
і і і started. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_BrowserNotStarted і 2139 і The requested information is not і
і і і available. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_InternalError і 2140 і An internal error has occurred. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_BadTransactConfig і 2141 і The server is not configured for і
і і і transactions. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_InvalidAPI і 2142 і The requested API is not supported on і
і і і the remote server. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_BadUsername і 2202 і The pszUserID or pszGroupID parameter і
і і і is not valid. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_GroupExists і 2223 і The group name is already in use. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_UserExists і 2224 і The user account already exists. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_NotPrimary і 2226 і The UAS database is replicant and does і
і і і not allow updates. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_ACFNotLoaded і 2227 і The UAS database has not been started. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_ACFNoRoom і 2228 і There are too many names in the access і
і і і control file. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_ACFFileIOFail і 2229 і An error was encountered in accessing і
і і і the accounts database. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_InvalidComputer і 2351 і The specified computer name is not і
і і і valid. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_CanNotGrowUASFile і 2456 і It is not possible to enlarge the UAS і
і і і file. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_DCEError і 7500 і DCE error status returned. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_DCEErrorLogged і 7501 і DCE error status has been logged. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_RegistryNotFound і 7512 і Unable to contact the DCE security і
і і і registry. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_AuthTicketExpired і 7511 і The user's DCE authorization ticket і
і і і has expired. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_GroupExistsInCell і 7516 і The group already exists in the cell. і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NERR_ResDomMaxGroupEntries і 7525 і The resource domain already contains і
і і і the maximum number of entries per- і
і і і mitted. і
АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ


Other codes could be returned from the following functions:

• DosFsCtl
  
• DosGetShrSeg
Related Information

For information about:

• Adding a user to a group, see Group - NetGroupAddUser. 
  Assigning group permissions, see Access Permission - NetAccessAdd.
  
  Deleting a group account from a server, see Group - NetGroupDel.
  
  Listing all groups on a server, see Group - NetGroupEnum.

  ---

  [Back] [Next]