Roles API

[Eric Olson]

Here is the current exposed Roles soap API for the Venue.
They can easily be added, removed, or renamed at this time, so take a 
quick look if you have a minute.  I beliebe you have to be an 
Administrator to access all of them except the last one.

Venue.
  AddSubjectToRole(subject, role_string)
  RemoveSubjectFromRole(subject, role_string)
  SetSubjectsInRole(subject_list, role_string):
  AddRole(role_string)
  GetUsersInRole(role_string)
    (It seems both "Subject" and "User" are used, which is better?)
  GetRoleNames()
    returns list of strings
  GetAvailableGroupRoles()
    returns groups the venue knows about as list of strings.
    examples include All Users or Server Administrators


Users also probably would like to know which roles they are in.
   -- specifically so the venueclient can know if the user is a venue 
administrator and if so, provide a button to administrate the venue.
   I'm proposing something like the following:

  DetermineRoles(subject="")
    returns a list of role names that the user is in.
    only authorized for this call if you are requesting your own roles or 
    you are an administrator.

Comments requested,
Eric