infoRouter Document Management System - Web Services API Documentation Version 7.0
GetDomainMembers
Returns a list of users and user groups who are members of the specified domain.
Syntax
[Visual Basic]
Public Shared Function GetDomainMembers(ByVal AuthenticationTicket As String, _
Byval DomainName as string) as xmldocument
Parameters

AuthenticationTicket

infoRouter Authentication Ticket

DomainName

The domain name of the members to be listed


Return Value
returns xml fragment.
<response success="true" error="">
if success = "true", the <users> and <usergroups> sub nodes to be returned.
if success = "false", the error attribute returns the error description.
Remarks
The caller must be the system administrator or the domain manager of the specified domain.
Example
Public Sub GetDomainMembers()
Const IRAuthenticationTicket As String = "sid-xxxxxxxxxxxx"
Const IR_DomainName As String = "Accounting"

Dim IR_Obj As InfoRouter.srv
Dim xmlResponse As System.Xml.XmlElement
Try

IR_Obj = New InfoRouter.srv
xmlResponse = IR_Obj.GetDomainMembers(IRAuthenticationTicket, _
IR_DomainName)

If xmlResponse.GetAttribute("success") = "true" Then
Dim xmlelem As System.Xml.XmlElement
'list users
Console.WriteLine("------- [Member Users] ----------")

Dim xmlusersElem As System.Xml.XmlElement
xmlusersElem = xmlResponse.ChildNodes(0)
For Each xmlelem In xmlusersElem.ChildNodes
Console.WriteLine(xmlelem.GetAttribute("UserName"))
Next
xmlusersElem = Nothing

'list usergroups
Console.WriteLine("------- [Member Groups] ---------")
Dim xmlusergroupsElem As System.Xml.XmlElement
xmlusergroupsElem = xmlResponse.ChildNodes(0)
For Each xmlelem In xmlusergroupsElem.ChildNodes
Console.WriteLine(xmlelem.GetAttribute("GroupName"))
Next
xmlusergroupsElem = Nothing

Else
Console.WriteLine("Domain members cannot be reached.")
Console.WriteLine("server response:" & xmlResponse.GetAttribute("error"))
End If
xmlResponse = Nothing

Catch ex As Exception
Console.WriteLine("error:" & ex.Message)
Finally
IR_Obj = Nothing
End Try

End Sub
See Also
AddUserAsDomainMember | RemoveUserFromDomainMembership | AddUserGroupAsDomainMember | RemoveUserGroupFromDomainMembership
Web Services API Syntax based on infoRouter Document Management System Version 7.0
Copyright() 1998-2008 Active Innovations, Inc.
infoRouter Electronic Document Management Software