Compartilhar via


Utility.SearchPrincipals método

Retorna a coleção de objetos que parcialmente ou exclusivamente correspondem ao critério de pesquisa especificado.

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 SearchPrincipals ( _
    context As ClientRuntimeContext, _
    web As Web, _
    input As String, _
    scopes As PrincipalType, _
    sources As PrincipalSource, _
    usersContainer As UserCollection, _
    maxCount As Integer _
) As IList(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 maxCount As Integer
Dim returnValue As IList(Of PrincipalInfo)

returnValue = Utility.SearchPrincipals(context, _
    web, input, scopes, sources, usersContainer, _
    maxCount)
public static IList<PrincipalInfo> SearchPrincipals(
    ClientRuntimeContext context,
    Web web,
    string input,
    PrincipalType scopes,
    PrincipalSource sources,
    UserCollection usersContainer,
    int maxCount
)

Parâmetros

  • 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.

    Ele não deve ser NULL. Seu comprimento deve ser igual ou menor do que 255.

  • maxCount
    Tipo: System.Int32

    Especifica o número máximo de objetos a ser retornado na lista.

    Se o valor for igual ou menor do que 0, o servidor deve retornar uma coleção vazia.

Valor retornado

Tipo: System.Collections.Generic.IList<PrincipalInfo>
Retorna uma instância de IList<T> que representa a coleção de objetos que parcialmente ou exclusivamente correspondem ao critério de pesquisa especificado.

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