The NetGroupSetInfo function sets the parameters of a global group account.
Only members of the Administrators or Account Operators local group can successfully execute NetGroupSetInfo.
NET_API_STATUS NetGroupSetInfo(
LPWSTR servername,
LPWSTR groupname,
DWORD level,
LPBYTE buf,
LPDWORD parm_err
);
Value | Meaning |
---|---|
0 | Specify group name. The specified buffer points to an array of GROUP_INFO_0 structures. |
1 | Specifiy group name and comment. The specified buffer points to an array of GROUP_INFO_1 structures. |
2 | Specify information about the group. The specified buffer points to an array of GROUP_INFO_2 structures. |
1002 | Specify comments about the group. The specified buffer points to an array of GROUP_INFO_1002 structures. |
1005 | Specify group attributes. The specified buffer points to an array of GROUP_INFO_1005 structures. |
You can call NetGroupSetInfo with GROUP_INFO_1 and specify a value using the grpi1_name member. However, that value will be ignored. The correct way to specify the new name of the group is to call NetGroupSetInfo with GROUP_INFO_0 and specify a value using grpi0_name.
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_GroupNotFound | The group name could not be found. |
NERR_SpeGroupOp | The operation is not allowed on specified special groups, which are user groups, admin groups, local groups, or guest groups. |
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in lmaccess.h.
Import Library: Use netapi32.lib.
Networking (Net) Overview, Net Functions, NetGroupGetInfo