[This is preliminary documentation and is subject to change.]

public string ADSearch(
	string criteria,
	WinNetworkBrowserCriteriaTypes criteriaType,
	string sidNameField,
	string site,
	string ou,
	string adsPath,
	WinNetworkBrowserADObjectClasses objectClass,
	string arrayDelimiter,
	string[] extraFields
)

Public Function ADSearch ( 
	criteria As String,
	criteriaType As WinNetworkBrowserCriteriaTypes,
	sidNameField As String,
	site As String,
	ou As String,
	adsPath As String,
	objectClass As WinNetworkBrowserADObjectClasses,
	arrayDelimiter As String,
	extraFields As String()
) As String

Parameters

criteria

Type: SystemString
The search criteria, can be a regular search text or a Sid in the SSDL format e.g. S-1-5-21-3000480078-1234539488-920655208-1108. If the criteria is the samAccountName (login name) of an object, do not include the domain name with the criteria.

criteriaType

Type: ContentStudio.SecurityWinNetworkBrowserCriteriaTypes
The type of criteria passed in the criteria parameter

sidNameField

Type: SystemString
If the CriteriaType is sid this parameter contains the name of the sid field to search. If this parameter is null or Empty "objectSID" is used. This parameter is ignored if CriteriaType is not Sid. Normally this parameter is null

site

Type: SystemString

This parameter is ignored if adsPath is specified.

The domain to search in e.g. teknikhuset.com. If this parameter is null or Empty, ou must also be null or String.Empty.

ou

Type: SystemString

This parameter is ignored if adsPath is specified.

The OU:s (Organizational Unit) of the site to search in (e.g. Developers/Staff/Umeå). If there are underlying OU:s, these are included in the search as well. Specify null or Empty to search in the whole domain.

Note
This path must be written in the same order as the ADSPath i.e from the lowest OU in the hierarchy up to the root OU.

adsPath

Type: SystemString
An LDAP path to use. Pass null or String.Empty to use the site / ou parameters instead. If all these 3 parameters is unspecified the current domain is used.

objectClass

Type: ContentStudio.SecurityWinNetworkBrowserADObjectClasses
Defines what type of object to find.

To find	Use
Users	ADObjectClasses.Top or ADObjectClasses.Person or ADObjectClasses.User or ADObjectClasses.UsersAndGroups
Groups	ADObjectClasses.Top or ADObjectClasses.Group or ADObjectClasses.UsersAndGroups
Computers	ADObjectClasses.Top or ADObjectClasses.Person or ADObjectClasses.Computer
Contact	ADObjectClasses.Top or ADObjectClasses.Person or ADObjectClasses.Computer

arrayDelimiter

Type: SystemString
A delimiter to use in case a property sought for contains more than one value. If this parameter is if omitted, a pipe surrounded by blanks (" | ") is used.

extraFields

Type: SystemString
An array of that defines one or more of the extra fields that should be returned. This parameter can be null or an empty array. As default only the type, cn, and ADSPath will be returned. To return the NT login domain use the "domainNetBIOSName" field name.

Return Value

<root>
  <status>0</status>
  <statustext>Success</statustext>
  <list>
    <object type="user" 
               cn="Linda Liar" 
               adspath="LDAP://CN=Liar Linda,OU=Development Unit,DC=theCompany,DC=com" 
               objectsid="S-1-5-21-2060480071-1212121288-620655208-1145" 
               samaccountname="lialin" 
               telephonenumber="" />
  </list>
</root>

The following code snippet shows how to search for a user in Active Directory and return some fields of data.

//Define a search criteria
var criteria = "*Linda";
//define an number of fields to return (AD field names can be case sensitive)
var extraFields = new string[5] { "cn", "objectClass", "objectSID", "samAccountName", "telephoneNumber" };
var wnb = new WinNetworkBrowser();
//The xml returned is the one documented here as return value
var xml = wnb.ADSearch(criteria,
                       WinNetworkBrowser.CriteriaTypes.Regular,
                       "objectSID",
                       "theCompany.com",
                       "Development Unit",
                       null,
                        WinNetworkBrowser.ADObjectClasses.User,
                       ",",
                       extraFields);

'Define a search criteria
Dim criteria As String = "*Linda"
'define an number of fields to return (AD field names can be case sensitive)
Dim extraFields As New String() = New String(4) { "cn", "objectClass", "objectSID", "samAccountName", "telephoneNumber" }
Dim wnb As New WinNetworkBrowser()
'The xml returned is the one documented here as return value
string xml = wnb.ADSearch(criteria, _
                          WinNetworkBrowser.CriteriaTypes.Regular, _
                          "objectSID", _
                          "theCompany.com", _
                          "Development Unit", _
                          null, _
                          WinNetworkBrowser.ADObjectClasses.User, _
                          ",", _
                          extraFields)

Reference