AddUserRoleAssignment

Adds a role assignment to the user profile.

Syntax

IRoleAssignment AddUserRoleAssignment(IHierarchicalZone zone)

IRoleAssignment AddUserRoleAssignment(IHierarchicalZoneComputer computer)

Parameters

Specify one of the following parameters when using this method.

Parameter Description
zone The zone to which the Windows user belongs.
computer The computer to which the Windows user belongs.

Return value

An empty user role assignment object. This role assignment is not stored in Active Directory until you call the RoleAssignment:Commit method.

Discussion

When you assign computer-level overrides for user, group, or computer role assignments, internally IBM Security creates a computer zone object, which is a special type of zone that contains the users, groups, and computer role assignments that are specific to only that one computer. Use the second form of this method to obtain a computer-level role assignment for this user.

Exceptions

AddUserRoleAssignment may throw one of the following exceptions:

  • ArgumentNullException if the specified parameter value is null.

  • ApplicationException if the parameter value is not a valid user or if the method failed to create a role assignment because it cannot find the user.