Utility.ResolvePrincipal método

Artigo
05/11/2016

Retorna informações sobre uma entidade de segurança que corresponde aos critérios de pesquisa especificados. Se nenhuma correspondência for encontrada, o servidor deve retornar NULL.

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

Sintaxe

'Declaração
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)
'Uso
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)

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

Parâmetros

context
Tipo: Microsoft.SharePoint.Client.ClientRuntimeContext

web
Tipo: Microsoft.SharePoint.Client.Web

Especifica o site para ser usado ao procurar por uma entidade de segurança.

Ele não deve ser NULL.

input
Tipo: System.String

Especifica o valor a ser usada ao procurar por uma entidade de segurança.

Se isso não for o nome de exibição, endereço de email ou nome de login de um capital, o servidor deve retornar NULL

Seu comprimento deve ser igual ou menor do que 255.

scopes
Tipo: Microsoft.SharePoint.Client.Utilities.PrincipalType

Especifica o tipo a ser usada ao procurar por uma entidade de segurança.

sources
Tipo: Microsoft.SharePoint.Client.Utilities.PrincipalSource

Especifica a origem a ser usada ao procurar por uma entidade de segurança.

usersContainer
Tipo: Microsoft.SharePoint.Client.UserCollection

Especifica o conjunto de usuários a ser usada ao procurar por uma entidade de segurança.

inputIsEmailOnly
Tipo: System.Boolean

Especifica se apenas o endereço de email será usado quando pesquisando uma entidade de segurança.

Valor retornado

Tipo: Microsoft.SharePoint.Client.ClientResult<PrincipalInfo>
Retorna uma instância de ClientResult<T> representando ferramentas para conversão de formatos de data e hora, para obter informações de nomes de usuário, para modificar o acesso a sites e várias outras tarefas de gerenciamento de implantação.

Exceções

Exceção	Condição
[System.UnauthorizedAccessException]	O usuário atual tem permissões suficientes. Código de erro: -2147024891.

Ver também

Referência

Utility classe

Utility membros

Microsoft.SharePoint.Client.Utilities namespace

Compartilhar via