NetLocalGroupAdd

The NetLocalGroupAdd function creates a local group in the security database.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetLocalGroupAdd.

NET_API_STATUS NetLocalGroupAdd(
  LPWSTR servername, 
  DWORD level,       
  LPBYTE buf,        
  LPDWORD parm_err   
);

Parameters

servername
Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.
level
Specifies one of the following values to set the level of information pointed to in the buf parameter.
Value Meaning
0 Specify local group name of the user. The specified buffer points to an array of LOCALGROUP_INFO_0 structures.
1 Specify local group attributes of the user. The specified buffer points to an array of LOCALGROUP_INFO_1 structures.

buf
Pointer to a buffer containing the local group information structure.
parm_err
Optional pointer to a DWORD that returns the index of the first parameter to cause ERROR_INVALID_PARAMETER. If NULL the parameter is not returned on error.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
NERR_InvalidComputer The computer name is invalid.
NERR_NotPrimary The operation is allowed only on the primary domain controller of the domain.
NERR_GroupExists The group already exists.
NERR_UserExists The user account already exists.
ERROR_ALIAS_EXISTS An error occurs when accessing the alias.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmaccess.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetLocalGroupDel