Utility.ResolvePrincipal - Méthode
Renvoie des informations sur une entité qui correspond à des critères de recherche spécifiés. Si aucune correspondance ne figure, le serveur doit renvoyer NULL.
Espace de noms : Microsoft.SharePoint.Client.Utilities
Assemblys : Microsoft.SharePoint.Client.Silverlight (dans Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (dans Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (dans Microsoft.SharePoint.Client.dll)
Syntaxe
'Déclaration
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)
'Utilisation
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
)
Paramètres
- context
Type : Microsoft.SharePoint.Client.ClientRuntimeContext
web
Type : Microsoft.SharePoint.Client.WebSpécifie le site à utiliser lors de la recherche pour une identité.
Il ne doit pas être NULL.
input
Type : System.StringSpécifie la valeur à utiliser lors de la recherche pour une identité.
Si ce n'est pas le nom complet, une adresse de messagerie ou un nom de connexion d'un investissement, le serveur doit renvoyer NULL
Sa longueur doit être inférieure ou égale à 255 à.
scopes
Type : Microsoft.SharePoint.Client.Utilities.PrincipalTypeSpécifie le type à utiliser lors de la recherche pour une identité.
sources
Type : Microsoft.SharePoint.Client.Utilities.PrincipalSourceSpécifie la source à utiliser lors de la recherche pour une identité.
usersContainer
Type : Microsoft.SharePoint.Client.UserCollectionSpécifie la collection d'utilisateurs à utiliser lors de la recherche pour une identité.
inputIsEmailOnly
Type : System.BooleanSpécifie si uniquement l'adresse de messagerie sera utilisé lors de la recherche pour une identité.
Valeur renvoyée
Type : Microsoft.SharePoint.Client.ClientResult<PrincipalInfo>
Renvoie une instance de ClientResult<T> représentant des outils permettant de convertir les formats de date et heure, pour obtenir des informations à partir de noms d'utilisateur, de modification de l'accès aux sites et des différentes autres tâches de gestion du déploiement.
Exceptions
Exception | Condition |
---|---|
[System.UnauthorizedAccessException] | L'utilisateur actuel dispose des autorisations suffisantes. Code d'erreur : -2147024891. |