NetGroupDelUser

The NetGroupDelUser function removes a user from a particular global group in the security database.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetGroupDelUser.

NET_API_STATUS NetGroupDelUser(
  LPWSTR servername, 
  LPWSTR GroupName,  
  LPWSTR Username    
);

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.
GroupName
Pointer to a Unicode string containing the name of the global group from which the user membership is to be removed.
Username
Pointer to a Unicode string containing the name of the user to remove from the global group.

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
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_SpeGroupOp The operation is not allowed on specified special groups, which are user groups, admin groups, local groups, or guest groups..
NERR_UserNotFound The user name could not be found.
NERR_GroupNotFound The group name could not be found.
NERR_UserNotInGroup The user does not belong to this group.

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, NetGroupAddUser