/// <summary>
/// marks the constructor private so only SetSecurityPrincipal can instantiate an
/// object of this class
/// </summary>
/// <param name="SecurityGroups">the list of security groups the user belongs too</param>
/// <param name="SecurityRights">the list of security rights the user has</param>
/// <param name="UserInfo">list of information we have about the user itself</param>
private static SecurityPrincipal SetSecurityValues(Hashtable pSecurityGroups, Hashtable pSecurityRights, Hashtable pUserInfo)
{
SecurityGroups = pSecurityGroups;
SecurityRights = pSecurityRights;
// creates the IIdentity for the user and associates it with this IPrincipal
TheUserIdentity = UserIdentity.CreateUserIdentity(pUserInfo);
return(new SecurityPrincipal());
}