SPUtility.ResolvePrincipal Method (SPWeb, String, SPPrincipalType, SPPrincipalSource, SPUserCollection, Boolean)

Resolves principal information into an SPPrincipalInfo object.

Namespace:  Microsoft.SharePoint.Utilities
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No

[ClientCallableExceptionConstraintAttribute(FixedId = "b", ErrorType = typeof(UnauthorizedAccessException), 
	Condition = "User does not have permission to Browse UserInfo list.")]
public static SPPrincipalInfo ResolvePrincipal(
	SPWeb web,
	string input,
	SPPrincipalType scopes,
	SPPrincipalSource sources,
	SPUserCollection usersContainer,
	bool inputIsEmailOnly


Type: Microsoft.SharePoint.SPWeb

An SPWeb object that represents a Web site.

Type: System.String

The display name, e-mail address, or login name that identifies the principal.

Type: Microsoft.SharePoint.Utilities.SPPrincipalType

An SPPrincipalType mask that indicates the type of principal to be resolved.

Type: Microsoft.SharePoint.Utilities.SPPrincipalSource

An SPPrincipalSource mask that indicates the source to be used in the resolution process.

Type: Microsoft.SharePoint.SPUserCollection

An SPUserCollection object that contains a set of principals.

Type: System.Boolean

A Boolean value that indicates the fields to be matched during the search for the principal. A value of true indicates that the match can be made by using only the e-mail address of a principal. A value of false indicates that a match can be made by using the any one of the display name, the e-mail address, or the login name of a principal.

Return Value

Type: Microsoft.SharePoint.Utilities.SPPrincipalInfo
An SPPrincipalInfo object that represents principal information.