Assign

Assigns a trustee to a role at the zone or computer level.

Syntax

IRoleAssignment Assign(DirectoryEntry trusteeDE, IComputer computer)

IRoleAssignment Assign(DirectoryEntry trusteeDE, IZone zone)

IRoleAssignment Assign(SearchResult trusteeSR, Icomputer computer)

IRoleAssignment Assign(SearchResult trusteeSR, IZone zone)

IRoleAssignment Assign(string trusteeDN, IComputer computer)

IRoleAssignment Assign(string trusteeDN, IZone zone)

Parameters

Use the following parameters with this method.

Parameter	Description
trusteeDE	The directory entry for the trustee (user or group) you want to add.
trusteeSR	The directory entry for a trustee specified as a search result.
trusteeDn	The trustee specified as a distinguished name.
computer	The computer to which you want to add the role.
zone	The zone to which you want to add the role.

Return value

The role assignment that includes the specified trustee. This role assignment is not stored in Active Directory until you call the RoleAssignment:Commit method.

Discussion

The Assign(DirectoryEntry trusteeDE, IComputer computer), Assign(SearchResult trusteeSr, IComputer computer), Assign(DirectoryEntry trusteeDE, IZone zone) and Assign(SearchResult trusteeSr, IZone zone) methods are available only for .NET-based programs.

Exceptions

Assign may throw one of the following exceptions:

• ApplicationException if the trustee is not a user or a group, you attempt to assign a role to a zone other than the containing or child zone, the methodfails to create a role assignment (see the message returned by the exceptionfor the reason), the method cannot find the trustee object or distinguished name in the specified search result, or the method cannot find the trustee.

• ArgumentException if any parameter is null or empty.