The NetGroupAdd function creates a global group in the security database.
Security Requirements
Only members of the Administrators or Account Operators local group can successfully execute NetGroupAdd.
NET_API_STATUS NetGroupAdd(
| 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 group name. The buf parameter contains a pointer to a GROUP_INFO_0 structure. |
| 1 | Specify group name and a comment. The buf parameter contains a pointer to a GROUP_INFO_1 structure. |
| 2 | Specifies information about the group. The buf parameter contains a pointer to a GROUP_INFO_2 structure. |
buf
Pointer to a buffer containing the global group information structure.
parm_err
Optional pointer to a DWORD to return the index of the first parameter in error when ERROR_INVALID_PARAMETER is returned. 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_GroupExists | The group already exists. |
| NERR_NotPrimary | The operation is allowed only on the primary domain controller of the domain. |
| ERROR_INVALID_LEVEL | The value specified for the Level parameter is invalid. |
| NERR_SpeGroupOp | The operation is not allowed on specified special groups, which are user groups, admin groups, local groups, or guest groups. |
See Also