NetLocalGroupDelMembers
The NetLocalGroupDelMembers
function removes one or more members from an existing local group.
Security Requirements
Only members
of the Administrators or Account Operators local group can successfully execute
NetLocalGroupDelMembers on a remote server.
NET_API_STATUS NetLocalGroupDelMembers(
|
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 from
which the specified users or global groups will be removed.
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 containing data that describes the removed members.
membercount
Specifies the
number of entries in the array 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 members do not exist. Therefore, no members were deleted. |
|
ERROR_MEMBER_IN_ALIAS
|
One or more
of the members specified were not members of the local group. Therefore, no
members were deleted. |
See Also