del método Utility.SearchPrincipals

Devuelve la colección de identidades que parcialmente o de forma exclusiva coinciden con los criterios especificados.

Espacio de nombres:  Microsoft.SharePoint.Client.Utilities
Ensamblados:   Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll)  Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)

Sintaxis

'Declaración
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

• context
  Tipo: Microsoft.SharePoint.Client.ClientRuntimeContext

• web
  Tipo: Microsoft.SharePoint.Client.Web

  Especifica el sitio que se utilizará cuando busque una entidad de seguridad.

  No debe ser NULL.

• input
  Tipo: System.String

  Especifica el valor que se utilizará cuando busque una entidad de seguridad.

  Si no es el nombre para mostrar, la dirección de correo electrónico o el nombre de inicio de sesión de una entidad de seguridad, el servidor debe devolver NULL.

  No debe ser NULL. Su longitud debe ser igual o inferior a 255.

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

  Especifica el tipo que se utilizará cuando busque una entidad de seguridad.

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

  Especifica el origen que pueden utilizarse para buscar una entidad de seguridad.

• usersContainer
  Tipo: Microsoft.SharePoint.Client.UserCollection

  Especifica la colección de usuarios que pueden utilizarse para buscar una entidad de seguridad.

• maxCount
  Tipo: System.Int32

  Especifica el número máximo de principales que se devolverán en la lista.

  Si el valor es igual a o menor que 0, el servidor debe devolver una colección vacía.

Valor devuelto

Tipo: System.Collections.Generic.IList<PrincipalInfo>
Devuelve una instancia de IList<T> que representa la colección de principales que parcialmente o de forma exclusiva coinciden con los criterios especificados.

Excepciones

Excepción	Condición
[System.UnauthorizedAccessException]	El usuario actual no tiene permisos suficientes. Código de error: -2147024891.

Vea también

Referencia

clase Utility

Miembros Utility

Espacio de nombres Microsoft.SharePoint.Client.Utilities