Visual Guard Class Library Documentation

VGRoles.RemoveUsersFromRoles Method (NTAccount[], String[])

Removes the specified Windows accounts from the specified roles.

public static void RemoveUsersFromRoles(
   NTAccount[] accounts,
   String[] roleNames
);

Parameters

accounts
An array of NTAccount objects to remove from the specified roles.
roleNames
A string array of role names to remove the specified users from. For shared roles, the name must be prefixed by '#'.

Exceptions

Exception Type Condition
ArgumentNullException roleNames is null or one of the roles specified is null.

-or-

accounts is null or one of the Windows account is null.
ArgumentException One of the roles is an empty string or contains invalid chars ('\', '/', '?', '*', '%', ';', ''', '"', ':', '|', '[', ']', '+', '=', ',').

-or-

roleNames contains a duplicate element.

-or-

accounts contains a duplicate element.

-or-

One of the roles was not found in the repository for the application.

-or-

One of the Windows accounts was not declared in the repository or cannot be converted to SID.
SecurityException The current user has not enough privileges to use Membership API. The Membership access level of the application must be sufficient to allows this action or the 'Membership Manager' role must be granted to the user by using the Visual Guard console.

See Also

VGRoles Class | Novalys.VisualGuard.Security.Membership Namespace | VGRoles.RemoveUsersFromRoles Overload List