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. |
See Also