Click or drag to resize

VGRolesAddUsersToRole Method (NTAccount, String, Guid)

Note: This API is now obsolete.

Adds the specified users to the specified role.

Namespace:  Novalys.VisualGuard.Security.Membership
Assembly:  Novalys.VisualGuard.Security (in Novalys.VisualGuard.Security.dll) Version: 2019.0.101.19 (2019.0.0101.19)
Syntax
[ObsoleteAttribute("This class is obsolete now, plz use VGSecurityManager.Runtime.Roles", 
	true)]
public static void AddUsersToRole(
	NTAccount[] accounts,
	string roleName,
	Guid applicationId
)

Parameters

accounts
Type: System.Security.PrincipalNTAccount
An array of Windows account to add to the specified role.
roleName
Type: SystemString
The role to add the specified user names to.
applicationId
Type: SystemGuid
The code of the application where you can find the specified roles.
Exceptions
ExceptionCondition
ArgumentNullExceptionroleName is null.

-or-

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

-or-

applicationId is null or the application Id is null.
ArgumentExceptionroleName 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.

-or-

applicationId was not found in the repository.
SecurityExceptionThe 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