NetLocalGroupAdd info  Overview  Group

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.

See Also

NetLocalGroupDel