Hosted CDI::GetUserSettings

The GetUserSettings procedure gets the current Customer Directory Integration (CDI) settings for a specified customer user.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the user in the Service Provider domain.

<preferredDomainController>

Yes

The name of the preferred domain controller in the Service Provider domain.

Remarks

Security

The GetUserSettings procedure has the following security requirements:

The caller is impersonated.

Minimum security role is UserCreators.

Sample Code

Example XML Request

The following is an example of an XML request for the GetUserSettings procedure of the Hosted CDI Namespace:

<?xml version="1.0" encoding="iso-8859-1" ?> 
<request> 
  <procedure> 
    <execute namespace="Hosted CDI" procedure="GetUserSettings" impersonate="1"> 
      <executeData> 
        <path>LDAP://CN=jimc@alpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</path> 
        <preferredDomainController>ad0l.fabrikam.com</preferredDomainController> 
      </executeData> 
    </execute> 
  </procedure> 
</request> 

Example XML Response

The following is an example of an XML response for the GetUserSettings procedure of the Hosted CDI Namespace:

<?xml version="1.0" encoding="iso-8859-1" ?> 
<response> 
  <data> 
    <path>LDAP://CN=jimc@alpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</path> 
    <remoteSamAccountName>jimc</remoteSamAccountName> 
    <remoteUserPrincipalName>jimc@alpine.com</remoteUserPrincipalName> 
    <preferredDomainController>ad0l.fabrikam.com</preferredDomainController> 
  </data> 
</response> 

Applies To

Hosted Customer Directory Integration Namespace API for:

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Hosted CDI::ModifyUser