VGRolesInstance.AddUsersToRole Method (NTAccount[], String)

Adds the specified users to the specified role.

public void AddUsersToRole(
NTAccount[] accounts,
String roleName
);

Parameters

accounts: An array of Windows account to add to the specified role.
roleName: The role to add the specified user names to.

Exceptions

Exception Type	Condition
ArgumentNullException	roleName is null. -or- accounts is null or one of the Windows account is null.
ArgumentException	roleName is an empty string or is longer than 64 characters or contains invalid chars ('\', '/', '?', '', '%', ';', ''', '"', ':', '\|', '[', ']', '+', '=', ','). -or- roleName* was not found in the repository. -or- accounts contains a duplicate element. -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.

Exception Type

Condition

ArgumentNullException

roleName is null.

-or-

accounts is null or one of the Windows account is null.

ArgumentException

roleName is an empty string or is longer than 64 characters or contains invalid chars ('\', '/', '?', '*', '%', ';', ''', '"', ':', '|', '[', ']', '+', '=', ',').

-or-

roleName was not found in the repository.

-or-

accounts contains a duplicate element.

-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.

VGRolesInstance.AddUsersToRole Method (NTAccount[], String)

Parameters

Exceptions

See Also