Opération DisableAppDisableApp operation

Trouvez des informations sur l’opération EWS DisableApp .Find information about the DisableApp EWS operation.

L’opération DisableApp désactive une application de messagerie pour Outlook.The DisableApp operation disables a mail app for Outlook.

Cette opération est une nouveauté d’Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Utilisation de l’opération DisableAppUsing the DisableApp operation

L’opération DisableApp prend deux arguments dans la demande qui identifie l’application de messagerie à désactiver et la raison pour laquelle elle a été désactivée.The DisableApp operation takes two arguments in the request that identify the mail app to disable and the reason why it was disabled.

En-têtes SOAP d’opération DisableAppDisableApp operation SOAP headers

L’opération DisableApp peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.The DisableApp operation can use the SOAP headers that are listed in the following table.

Nom de l'en-têteHeader name ÉlémentElement DescriptionDescription
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifie la version de schéma de la demande d’opération.Identifies the schema version for the operation request. Cet en-tête s’applique à une demande.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifie la version du serveur qui a répondu à la demande.Identifies the version of the server that responded to the request. Cet en-tête s’applique à une réponse.This header is applicable to a response.

Exemple de requête d’opération DisableApp : désactiver une application de messagerie installée dans une boîte aux lettresDisableApp operation request example: Disable a mail app installed in a mailbox

L’exemple suivant de demande d’opération DisableApp montre comment désactiver une application de messagerie.The following example of a DisableApp operation request shows how to a disable a mail app. L’identificateur de l’application se trouve dans le manifeste de l’application qui est renvoyé dans une réponse d' opération GetAppManifests .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="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://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>

Le corps SOAP de la demande contient les éléments suivants :The request SOAP body contains the following elements:

Réponse de l’opération DisableApp réussieSuccessful DisableApp operation response

L’exemple suivant montre une réponse réussie à une demande d’opération DisableApp pour désactiver une application de messagerie.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="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </DisableAppResponse>
   </s:Body>
</s:Envelope>

Le corps SOAP de réponse contient les éléments suivants :The response SOAP body contains the following elements:

Réponse d’erreur d’opération DisableAppDisableApp operation error response

L’exemple suivant montre une réponse d’erreur à une demande d’opération DisableApp .The following example shows an error response to a DisableApp operation request. Il s’agit d’une réponse à une demande de désactivation d’une application de messagerie qui n’est pas installée dans une boîte aux lettres.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="https://schemas.microsoft.com/exchange/services/2006/types" xmlns="https://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="https://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>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :The error response SOAP body contains the following elements:

Pour les autres codes d’erreur qui sont génériques à EWS et spécifiques à cette opération, voir ResponseCode.For additional error codes that are generic to EWS and specific to this operation, see ResponseCode.

Voir aussiSee also