Active Directory Provider::Search
Performs a directory search in Active Directory directory service. Used by Microsoft Provisioning Framework (MPF).
Wrapper for IDirectorySearch.
Arguments
The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.
Remarks
No remarks
Schema Definition
Input
The schema should be as follows. A search can contain multiple search preferences. However, each preference can have only a single type and value.
<executeData>1..1
<path>1..1</path>
<filter>1..1</filter>
<propertyList>0..1
<property name="..">0..unbounded</property>
</propertyList>
<preferences>0..1
<preference>1..unbounded
<searchPref>1..1</searchPref>
<type>1..1</type>
<value>1..1</value>
</preference>
</preferences>
</executeData>
Output
Sample Code
Example XML Request
The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.
<request>
<procedure>
<execute namespace="Active Directory Provider" procedure="Search" impesonate="1">
<executeData>
<path>LDAP://ad01.fabrikam.com/OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=FAbrikam,DC=Com</path>
<filter>objectClass=user</filter>
<propertyList>
<property name="sAMAccountName" />
</propertyList>
<preferences>
<preference>
<searchPref>ADS_SEARCHPREF_SEARCH_SCOPE</searchPref>
<type>ADSTYPE_INTEGER</type>
<value>ADS_SCOPE_ONELEVEL</value>
</preference>
</preferences>
</executeData>
<after source="executeData" destination="data" mode="insert" />
</execute>
</procedure>
</request>
Example XML Response
The following code fragment shows the format for data this procedure returns. For more information on individual elements and attributes, see the Elements and Attributes table.
<response>
<data>
<executeData>
<path>LDAP://ad01.fabrikam.com/OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=FAbrikam,DC=Com</path>
<filter>objectClass=user</filter>
<propertyList>
<property name="sAMAccountName"/>
</propertyList>
<preferences>
<preference>
<searchPref>ADS_SEARCHPREF_SEARCH_SCOPE</searchPref>
<type>ADSTYPE_INTEGER</type>
<value>ADS_SCOPE_ONELEVEL</value>
</preference>
</preferences>
<objects>
<object class="user"
name="JohnC@AlpineSkiHouse.com">
<property name="sAMAccountName">
<value>JohnC_AlpineSkiHouse</value>
</property>
</object>
<object class="user"
name="KimA@AlpineSkiHouse.com">
<property name="sAMAccountName">
<value>KimA_AlpineSkiHouse_</value>
</property>
</object>
</objects>
</executeData>
</data>
</response>
Applies To
Active Directory Provider for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0
Hosted Messaging and Collaboration version 3.5
Hosted Messaging and Collaboration version 3.0
Windows-based Hosting version 4.5
Windows-based Hosting version 4.0
Windows-based Hosting version 3.5
Windows-based Hosting for Applications version 1.0