Share via

Managed Active Directory::GetThisOrganizationRoot

  • Article

The GetThisOrganizationRoot method returns 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>.

Arguments

Input Arguments Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the object to find the root organization for

<preferredDomainController>

No

The domain controller to be used for this request

Remarks

Security

  • Impersonate caller.

Sample Code

Example XML Request

<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>

Example XML Response

<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>

Applies To

Managed Active Directory Namespace APIManaged Active Directory Namespace API 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