listDomainControllers

Returns all or a portion of a domain's domain controller list.

Request

<listDomainControllers>
   <domain/>
   <startIdx/>
   <numEntries/>
   <unp/>
   <user/>
   <password/>
</listDomainControllers>

<listDomainControllers>
   <server/>
   <result value=" ">
      <description/>
   </result> 
</listDomainControllers>

domain: (Optional) Specifies the distinguished name of the eDirectory domain object. The name must be a fully distinguished name, including the leading dot before the object name and the trailing dot after the tree name (or with no leading or trailing dot but a complete identity of the object within the current tree). The default is the domain object that is associated with the CIFS server you are talking to.
startIdx: (Optional) Specifies the starting index of the first domain controller to return. Defaults to 0 (start at the beginning).
numEntries: (Optional) Specifies the maximum number of domain controllers to return in the reply. Defaults to return all controllers.
unp: (Optional) Specifies the NMAS-encrypted username and password that has rights to perform the operation at the specified context.
user: (Optional) Specifies the clear-text user name of a user that has rights to perform the operation. This element is used only if the unp element is not specified.
password: (Optional/Required if user is specified) Specifies the clear-text password of a user that has rights to perform the operation.
server: Specifies the eDirectory name (in typeless, distinguished-name format) of the server that is acting as a domain controller in the domain.
result: Specifies a zError or eDirectory value or 0 (for no error).
description: Specifies a text description of the result.