DisableApp operation
Find information about the DisableApp EWS operation.
The DisableApp operation disables a mail app for Outlook.
This operation was introduced in Exchange Server 2013.
The DisableApp operation takes two arguments in the request that identify the mail app to disable and the reason why it was disabled.
The DisableApp operation can use the SOAP headers that are listed in the following table.
| Header name | Element | Description |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Identifies the schema version for the operation request. This header is applicable to a request. |
| ServerVersion |
ServerVersionInfo |
Identifies the version of the server that responded to the request. This header is applicable to a response. |
The following example of a DisableApp operation request shows how to a disable a mail app. The app identifier can be found in the app manifest that is returned in a GetAppManifests operation response.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
<t:MailboxCulture>en-US</t:MailboxCulture>
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="GMT Standard Time"/>
</t:TimeZoneContext>
</soap:Header>
<soap:Body >
<m:DisableApp>
<m:ID>1C50226D-04B5-4AB2-9FCD-42E236B59E4B</m:ID>
<m:DisableReason>NoReason</m:DisableReason>
</m:DisableApp>
</soap:Body>
</soap:Envelope>
The request SOAP body contains the following elements:
The following example shows a successful response to a DisableApp operation request to disable a mail app.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="556"
MinorBuildNumber="14"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<DisableAppResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
</DisableAppResponse>
</s:Body>
</s:Envelope>
The response SOAP body contains the following elements:
The following example shows an error response to a DisableApp operation request. This is a response to a request to disable a mail app that is not installed in a mailbox.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15" MinorVersion="0" MajorBuildNumber="556" MinorBuildNumber="14" Version="Exchange2013" xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" xmlns="http://schemas.microsoft.com/exchange/services/2006/types" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<DisableAppResponse ResponseClass="Error" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>Extension ID 1C50226D-04B5-4AB2-9FCD-42E236B59E4A can't be found.</MessageText>
<ResponseCode>ErrorExtensionNotFound</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</DisableAppResponse>
</s:Body>
</s:Envelope>
The error response SOAP body contains the following elements:
For additional error codes that are generic to EWS and specific to this operation, see ResponseCode.