Utility.ResolvePrincipal Method

Returns information about a principal that matches the specified search criteria. If no matches are found, the server must return NULL.

Namespace:  Microsoft.SharePoint.Client.Utilities
Assemblies:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)

Syntax

'Declaration
<RemoteAttribute> _
Public Shared Function ResolvePrincipal ( _
    Context As ClientRuntimeContext, _
    web As Web, _
    input As String, _
    scopes As PrincipalType, _
    sources As PrincipalSource, _
    usersContainer As UserCollection, _
    inputIsEmailOnly As Boolean _
) As ClientResult(Of PrincipalInfo)
'Usage
Dim Context As ClientRuntimeContext
Dim web As Web
Dim input As String
Dim scopes As PrincipalType
Dim sources As PrincipalSource
Dim usersContainer As UserCollection
Dim inputIsEmailOnly As Boolean
Dim returnValue As ClientResult(Of PrincipalInfo)

returnValue = Utility.ResolvePrincipal(Context, _
    web, input, scopes, sources, usersContainer, _
    inputIsEmailOnly)

[RemoteAttribute]
public static ClientResult<PrincipalInfo> ResolvePrincipal(
    ClientRuntimeContext Context,
    Web web,
    string input,
    PrincipalType scopes,
    PrincipalSource sources,
    UserCollection usersContainer,
    bool inputIsEmailOnly
)

Parameters

• Context
  Type: Microsoft.SharePoint.Client.ClientRuntimeContext

• web
  Type: Microsoft.SharePoint.Client.Web

  Specifies the site to be used when searching for a principal.

  It must not be NULL.

• input
  Type: System.String

  Specifies the value to be used when searching for a principal.

  If this is not the display name, e-mail address, or login name of a principal, the server must return NULL

  Its length must be equal to or less than 255.

• scopes
  Type: Microsoft.SharePoint.Client.Utilities.PrincipalType

  Specifies the type to be used when searching for a principal.

• sources
  Type: Microsoft.SharePoint.Client.Utilities.PrincipalSource

  Specifies the source to be used when searching for a principal.

• usersContainer
  Type: Microsoft.SharePoint.Client.UserCollection

  Specifies the collection of users to be used when searching for a principal.

• inputIsEmailOnly
  Type: System.Boolean

  Specifies whether only the e-mail address will be used when searching for a principal.

Return Value

Type: Microsoft.SharePoint.Client.ClientResult<PrincipalInfo>
Returns a ClientResult<T> instance representing tools for converting date and time formats, for obtaining information from user names, for modifying access to sites, and for various other tasks in managing deployment.

Exceptions

Exception	Condition
[System.UnauthorizedAccessException]	The current user has insufficient permissions. Error code: -2147024891.

See Also

Reference

Utility Class

Utility Members

Microsoft.SharePoint.Client.Utilities Namespace