GetPrimaryUser

Returns the primary profile for the specified user.

Syntax

IHierarchicalUser GetPrimaryUser(DirectoryEntry userDE)

IHierarchicalUser GetPrimaryUser(SearchResult userSR)

IHierarchicalUser GetPrimaryUser(string userDn)

IHierarchicalUser GetPrimaryUser(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 the primary 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

The primary profile is the profile at the highest level in the zone hierarchy where the user’s profile is defined. All or part of the primary profile can be overridden by secondary profiles farther down in the hierarchy.

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

Exceptions

GetPrimaryUser throws an ArgumentNullException if the specified parameter value is null or empty, or if the user does not exist.