NetLocalGroupAddMembers

The NetLocalGroupAddMembers function adds membership of one or more existing user accounts or global groups to an existing local group. The function does not change the membership status of users or global groups that are currently members of the local group.

Security Requirements

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

NET_API_STATUS NetLocalGroupAddMembers(
  LPWSTR servername,      
  LPWSTR LocalGroupName,  
  DWORD level,            
  LPBYTE buf,             
  DWORD membercount       
);

Parameters

servername
Pointer to a null-terminated 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 null-terminated Unicode string containing the name of the local group to which the specified users or global groups will be added.
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 a buffer containing the data for the new members.
membercount
Specifies the number of entries in the buffer pointed to by the buf parameter.

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
NERR_GroupNotFound The local group specified by the groupname parameter does not exist.
ERROR_NO_SUCH_MEMBER One or more of the new members do not exist. Therefore, no new members were added.
ERROR_MEMBER_IN_ALIAS One or more of the members specified were already members of the local group. Therefore, no new members were added.
ERROR_INVALID_MEMBER One or more of the members cannot be added because their account type is invalid. Therefore, no new members were added.

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, NetLocalGroupAdd, NetLocalGroupDelMembers, NetLocalGroupGetMembers