Contact.FromPrincipalInfo method (SPPrincipalInfo)
Gets a Contact object, given the information about the principal.
Namespace: Microsoft.Office.Workflow.Utility
Assembly: Microsoft.Office.Workflow.Tasks (in Microsoft.Office.Workflow.Tasks.dll)
Syntax
'Declaration
Public Shared Function FromPrincipalInfo ( _
pi As SPPrincipalInfo _
) As Contact
'Usage
Dim pi As SPPrincipalInfo
Dim returnValue As Contact
returnValue = Contact.FromPrincipalInfo(pi)
public static Contact FromPrincipalInfo(
SPPrincipalInfo pi
)
Parameters
pi
Type: Microsoft.SharePoint.Utilities.SPPrincipalInfoInformation about the principal, for example, display name, job title, the department the principal belongs to, e-mail address and so on.
Return value
Type: Microsoft.Office.Workflow.Utility.Contact
A Contact object of the principal.
Remarks
An individual user (SPUser) gains access to a Windows SharePoint Services object directly through an individual role assignment, or indirectly through membership in either a domain group or a SharePoint group (SPGroup) that has a role assignment. In a direct role assignment, the user is the principal (SPPrincipal), while in a domain group or SharePoint group role assignment, the domain group or SharePoint group is the principal.
For more information about principal objects, see Authorization object relations and object model in the Microsoft Windows SharePoint Services 3.0 SDK.
For an example of how to use some of the members in the Contact class, see the example in ExpandGroups method.