People.ResolvePrincipals, méthode (websvcPeople)

Article
02/01/2010

Resolves an e-mail address or other form of user identification (ID) into a PrincipalInfo object.

Espace de noms : websvcPeople
Assembly : STSSOAP (dans stssoap.dll)

Syntaxe

'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/ResolvePrincipals", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
Public Function ResolvePrincipals ( _
    principalKeys As String(), _
    principalType As SPPrincipalType, _
    addToUserInfoList As Boolean _
) As PrincipalInfo()
'Utilisation
Dim instance As People
Dim principalKeys As String()
Dim principalType As SPPrincipalType
Dim addToUserInfoList As Boolean
Dim returnValue As PrincipalInfo()

returnValue = instance.ResolvePrincipals(principalKeys, principalType, addToUserInfoList)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/ResolvePrincipals", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
public PrincipalInfo[] ResolvePrincipals (
    string[] principalKeys,
    SPPrincipalType principalType,
    bool addToUserInfoList
)

Paramètres

principalKeys
Logon name of the principal.

principalType
SPPrincipalType object that specifies user scope and other information.

addToUserInfoList
Indicates whether to add the principal to a SPUserCollection that is associated with the Web site.

Valeur retournée

A list of PrincipalInfo objects that is indexed and accessed by the logon name in the AccountName field.

Notes

A user may have more than one type of authorization access within a Web site. For example, a user may be part of a Windows SharePoint Services group and a distribution list, in addition to having Web site access that is authorized by their logon name. Consequently, there may be multiple copies of a user ID that are associated with a Web site.

Use this field when an implementation does not have an appropriate SPPrincipalInfo object with which to represent a user, and when the implementation needs to check user permissions for the site, grant user permissions for site objects, or perform some other security operation.

User verification is performed against a directory or user list, such as Active Directory Domain Services (AD DS), a Lightweight Directory Access Protocol (LDAP) directory, some other role or membership providers, or another form of user list.

Voir aussi

Référence

People, classe
Membres People
websvcPeople, espace de noms
SearchPrincipals

Partager via