People.ResolvePrincipals Method
Resolves an e-mail address or other form of user identification (ID) into a PrincipalInfo object.
Namespace: [People Web service]
Web service reference: http://Site/_vti_bin/People.asmx
Syntax
'Declaration
<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()
'Usage
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
)
Parameters
principalKeys
Type: []Logon name of the principal.
principalType
Type: [People Web service].SPPrincipalTypeSPPrincipalType object that specifies user scope and other information.
addToUserInfoList
Type: System.BooleanIndicates whether to add the principal to a SPUserCollection that is associated with the Web site.
Return Value
Type: []
A list of PrincipalInfo objects that is indexed and accessed by the logon name in the AccountName() field.
Remarks
A user may have more than one type of authorization access within a Web site. For example, a user may be part of a SharePoint Foundation 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.