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