NetLocalGroupSetMembers

The NetLocalGroupSetMembers function sets the local group membership for the specified local group. Each user or global group specified is made a member of the local group. Users or global groups that are not specified but are currently members of the local group will have their membership revoked.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetLocalGroupSetMembers on a remote server.

NET_API_STATUS NetLocalGroupSetMembers(
  LPWSTR servername,      
  LPWSTR LocalGroupName,  
  DWORD level,            
  LPBYTE buf,             
  DWORD totalentries      
);

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.
LocalGroupName
Pointer to a Unicode string containing the name of the local group to which the specified users or global groups belong.
level
Specifies one of the following values to set the level of information provided.
Value Meaning
0 The buf parameter points to an array of LOCALGROUP_MEMBERS_INFO_0 structures.
3 The buf parameter points to an array of LOCALGROUP_MEMBERS_INFO_3 structures.

buf
Pointer to the buffer in which the data to be set is stored.
totalentries
Specifies the total number of entries in the buffer that the buf parameter points to.

Return Values

If the function returns account information, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value Meaning
NERR_GroupNotFound The specified LocalGroupName does not exist.
ERROR_NO_SUCH_MEMBER One or more of the members doesn't exist. Therefore, the local group membership was not changed.
ERROR_INVALID_MEMBER One or more of the members cannot be added because it has an invalid account type. Therefore, the local group membership was not changed.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmaccess.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetLocalGroupGetMembers