Hosted Email 2007::DeleteFolderByGUID

This procedure must perform the following actions as performed by Hosted Email 2007::DeleteFolderByGUID.

Arguments

Input Arguments Required Type Description

<GUID>

Yes

string

The GUID of the organization with the public folder allocation.

<Name>

Yes

string

The name of the Public Folder.

<Server>

No

string

This parameter specifies the server on which the public folder resides.

This parameter is required if more than one Public Folder store is present.

<preferredDomainController>

Yes

string

The domain controller to use for Active Directory operations. Use the fully qualified domain name (FQDN) of the domain controller that you want to use.

Output Arguments

A successful request will mirror the input data.

Remarks

This procedure must assume that the Organization as well as its child objects do not exist in Active Directory.

This procedure should only be run in a scenario where an organization owning the Public Folder is not found in Active Directory.

Security

User must be a member of the DomainAdmins role to perform this action.

As an additional safeguard against improper modification toward a live tenant, an attempt should be made to bind to the supplied GUID of organization in Active Directory. If the Active Directory object referenced by GUID exists, the procedure should fail.

Error Handling

Error condition Error text

Active Directory object referenced by GUID exists.

The object with GUID %GUID% was found in Active Directory. This GUID parameter should only be used when the corresponding Active Directory object has been deleted.

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The GUID for organization own the public store. Both of two formats are supported: {08fd2bcd-dcd6-4d80-9cd4-1e88069e37f8} or cd2bfd08d6dc804d9cd41e88069e37f8--> 
    <GUID>cd2bfd08d6dc804d9cd41e88069e37f8</GUID> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--Specifies the name of the public folder.--> 
    <name>Legal</name> 
    <!--Obsolete. Specifies the server on which the public folder resides.--> 
    <server>ExMBXOAB01</server> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="DeleteFolderByGUID" impersonate="1"> 
      <before source="data" sourcePath="GUID" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="name" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="server" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Applies To

Hosted Email 2007 Namespace for:

  • Hosted Messaging and Collaboration version 4.5

See also

Tasks

Hosted Email 2007::DeleteFolder