The NetLocalGroupSetInfo function sets the parameters of a local group.
Only members of the Administrators or Account Operators local group can successfully execute NetLocalGroupSetInfo.
NET_API_STATUS NetLocalGroupSetInfo(
LPWSTR servername, | |
LPWSTR LocalGroupName, | |
DWORD level, | |
LPBYTE buf, | |
LPDWORD parm_err | |
); |
Value |
Meaning |
0 |
Specify the local group name of the user. The buf parameter points to an array of LOCALGROUP_INFO_0 structures. |
1 |
Specify local group attributes of the user. The buf parameter points to an array of LOCALGROUP_INFO_1 structures. |
1002 |
Specify local group attributes of the user. The buf parameter points to an array of LOCALGROUP_INFO_1002 structures. |
You can call NetLocalGroupSetInfo with LOCALGROUP_INFO_1 and specify a value using the lgrpi1_name member. However, that value will be ignored. The correct way to specify the new name of the group is to call NetLocalGroupSetInfo with LOCALGROUP_INFO_0 and specify a value using the lgrpi0_name member.
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_NotPrimary |
The operation is allowed only on the primary domain controller of the domain. |
NERR_InvalidComputer |
The computer name is invalid. |
ERROR_NO_SUCH_ALIAS |
The alias group does not exist. |