AddUserPartialProfile

Adds a computer-specific partial profile for the specified user to the computer.

Syntax

IHierarchicalUser AddUserPartialProfile(DirectoryEntry userDE)

IHierarchicalUser AddUserPartialProfile(SearchResult userSR)

IHierarchicalUser AddUserPartialProfile(string userDn)

IHierarchicalUser AddUserPartialProfile(IAdsUser userIAds)

Parameters

Specify one of the following parameters when using this method.

Parameter	Description
userDE	The directory entry for the user for which you want a partial profile.
userSr	The directory entry for a user specified as a search result.
userDn	The user specified as a distinguished name.
userIads	The IADs interface to the user.

Return value

The hierarchical user object that represents the user profile.

Discussion

When you assign computer-level overrides for user, group, or computer role assignments, IBM Security creates a computer zone, which is a special type of zone that contains the users, groups, and computer role assignments that are specific to only that one computer. Computer zones are not exposed as zones in Access Manager.

This method creates a computer zone and a new user profile with values set for the Cims and User properties. You can then add other properties to the profile.

The profile is not stored in Active Directory until you call the Commit method.

The AddUserPartialProfile(DirectoryEntry userDE) and AddUserPartialProfile(SearchResult userSr) methods are available only for .NET-based programs.

Exceptions

If you pass a null or empty parameter, AddUserPartialProfile throws the exception ArgumentNullException.

Example

The HierarchicalZoneComputer.AddUserPartialProfile method is used in the same way as the HierarchicalZone.AddUserPartialProfile method. See AddUserPartialProfile for an example.