DisableApp 操作DisableApp operation

Disableapp EWS 操作に関する情報を検索します。Find information about the DisableApp EWS operation.

Disableapp操作は、Outlook 用のメールアプリを無効にします。The DisableApp operation disables a mail app for Outlook.

この操作は Exchange Server 2013 で導入されました。This operation was introduced in Exchange Server 2013.

DisableApp 操作の使用Using the DisableApp operation

Disableapp操作は、要求で2つの引数を受け取り、無効にするメールアプリと、無効にされた理由を識別します。The DisableApp operation takes two arguments in the request that identify the mail app to disable and the reason why it was disabled.

DisableApp operation SOAP ヘッダーDisableApp operation SOAP headers

Disableapp操作では、次の表に記載されている SOAP ヘッダーを使用できます。The DisableApp operation can use the SOAP headers that are listed in the following table.

ヘッダー名Header name 要素Element 説明Description
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
操作要求のスキーマバージョンを識別します。Identifies the schema version for the operation request. このヘッダーは、要求に適用されます。This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
要求に応答したサーバーのバージョンを識別します。Identifies the version of the server that responded to the request. このヘッダーは応答に適用されます。This header is applicable to a response.

DisableApp 操作要求の例: メールボックスにインストールされたメールアプリを無効にするDisableApp operation request example: Disable a mail app installed in a mailbox

次のDisableapp operation 要求の例は、メールアプリを無効にする方法を示しています。The following example of a DisableApp operation request shows how to a disable a mail app. アプリ識別子は、 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>

要求 SOAP 本文には、次の要素が含まれています。The request SOAP body contains the following elements:

正常な DisableApp 操作応答Successful DisableApp operation response

次の例は、メールアプリを無効にするためのDisableapp操作要求に対する正常な応答を示しています。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>

応答 SOAP 本文には、次の要素が含まれています。The response SOAP body contains the following elements:

DisableApp 操作エラー応答DisableApp operation error response

次の例は、 Disableapp操作要求へのエラー応答を示しています。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="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>

エラー応答 SOAP 本文には、次の要素が含まれています。The error response SOAP body contains the following elements:

EWS で汎用的でこの操作に固有の追加のエラーコードについては、「応答」を参照してください。For additional error codes that are generic to EWS and specific to this operation, see ResponseCode.

関連項目See also