NetGroupDel

The NetGroupDel function deletes a global group account from the account database.

Security Requirements

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

NET_API_STATUS NetGroupDel(
  LPWSTR servername,  
  LPWSTR groupname    
);

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 account to delete.

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_GroupNotFound The group name could not be found.

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