Getting the owning organization of an object by using XML

Use the GetThisOrganizationRoot procedure of the Managed Active Directory namespace to return the owning organization of the supplied object. The owning organization will be either the hosting organization, a reseller, or a customer. The supplied object may be any member of the owning org. If you call this procedure and supply an object that happens to be an owning organization, the return value is the same as the supplied object.

To find the hosting organization that owns a reseller, or the reseller that owns a customer, call GetForeignOwnerOrg on the reseller or customer root organization.

This call is implemented internally by checking the other WellKnownObjects property of the containing organizational unit of the object (or the object itself, if it is an organizational unit). If the object is an organizational unit, it's organization root can be bound to as LDAP://<WKGUID=CC016CF08DEF4EA4A05C9C54B198785A, ou=Hosting,dc=contoso01.dc=com>.

This procedure expects to be called with impersonate="1". The procedure impersonates the caller.

Example of a request that calls the GetThisOrganizationRoot procedure

<request>
  <procedure>
	<execute namespace="Managed Active Directory" procedure="GetThisOrganizationRoot"
		impersonate="1">
	<executeData>
		<path>LDAP://cn=HostingUser,ou=Hosting,dc=contoso01,dc=com</path>
	</executeData>
	<after source="executeData" destination="data" />
	</execute>
  </procedure>
</request>

Input for GetThisOrganizationRoot

The following input is valid for this request:

LDAP path of the object for which you want to find the root organization
Use the <path> element to specify the Lightweight Directory Access Protocol (LDAP) path of the object for which you want to find the root organization.
```
<path>LDAP://LDAP path of the root organization</group>
```
Preferred domain controller (optional)
By using the <preferredDomainController> element, you can specify the domain controller that you want to use for this request. Using a single preferred domain controller eliminates replication delays that arise between multiple controllers.
```
<preferredDomainController>your domain controller</preferredDomainController>
```

Typical response for GetThisOrganizationRoot

This procedure returns the LDAP path of the owning organization.

<response>
  <data>
	<executeData>
	<path>LDAP://cn=HostingUser,ou=Hosting,dc=contoso01,dc=com</path>
	<root>LDAP://OU=Hosting,DC=contoso01,DC=com</root>
	</executeData>
  </data>
</response>

Important

Although Active Directory is not case sensitive for elements such as the Lightweight Directory Access Protocol (LDAP) path, XML is case sensitive. To ensure that the procedure executes appropriately, specify all tags, elements, and data using uppercase and lowercase letters exactly as shown in the XML examples. For additional guidelines on how to use XML, see the Microsoft Web site (http://www.microsoft.com/).