Unified Messaging 2007 Provider::GetUMMailboxPIN

This produres gets the Unified Messaging users pin and pin related values.

Arguments

Input Arguments	Required	Description
<preferredDomainController>	Yes	The domain controller to use for Active Directory actions.
<identity>	No	The identifier for the user. This can be in the form of a AD Object path, GUID, DN, Domain/SamAccountName, UPN, LegacyExchangeDN, SMTPAddress or Alias. Note sAMAccountName cannot be longer than 20 characters. See SAM-Account-Name Attribute for more information.
<resultSize >	No	This parameter specifies the number of results that may be returned.
<readFromDomainController >	No	This parameter specifies to read directly from the domain controller not the global catalog as it may be out of date.

Remarks

Security

The caller must be at least a member of role: OrgCreators.

Sample Code

Example XML Request

<request> 
        <data/> 
        <procedure> 
                <execute namespace='Unified Messaging 2007 Provider' procedure='GetUMMailboxPIN'> 
                        <executeData> 
                                <identity>Fabrikam\user1</indentity> 
                                <credential> 
                                        <username>fabrikam\administrator</username> 
                                        <password>Pass1word</password> 
                                </credential> 
                                <preferredDomainController>dc01.fabrikam.local</preferredDomainController> 
                                <resultSize>100</resultSize> 
                                <readFromDomainController>true</ readFromDomainController > 
                        </executeData> 
                </execute> 
        </procedure> 
</request> 

Example XML Response

<data> 
        <mailboxPINs> 
                <mailboxPIN name="mailboxname"> 
                        <properties> 
                                <property name="propertyName"> 
                                        <value>return value</value> 
                                        . 
                                        </property> 
                                . 
                        </ properties> 
                </mailboxPIN> 
        </mailboxPINs> 
</data> 

Applies To

• Hosted Messaging and Collaboration version 4.5

• Hosted Messaging and Collaboration version 4.0