GetAttachment-Vorgang

  • Artikel

Der GetAttachment-Vorgang wird verwendet, um vorhandene Anlagen für Elemente im Exchange-Speicher abzurufen.

GetAttachment-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel der GetAttachment-Anforderung zeigt, wie eine Anlage abgerufen wird.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <GetAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <AttachmentShape/>
      <AttachmentIds>
        <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
      </AttachmentIds>
    </GetAttachment>
  </soap:Body>
</soap:Envelope>

Kommentare

Mit dem AttachmentShape-Element können Sie angeben, welche Anlageninformationen zurückgegeben werden sollen. Ein leeres AttachmentShape-Element ist gültig und rendert Ihre Anlagen ohne MIME-Inhalt für Elementanlagen, mit einem Textkörpertyp und ohne zusätzliche Eigenschaften.

Mit der AttachmentIds-Auflistung können Sie mindestens einen Anlagenbezeichner angeben, der zurückgegeben werden soll. Beachten Sie, dass diese vom Typ RequestAttachmentIdType sind, sodass für alle AttachmentIds, die Sie von CreateAttachment erhalten, die Attribute RootItemId und RootItemChangeKey entfernt werden müssen, bevor sie an GetAttachment übergeben werden.

Hinweis

Der Anlagenbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

GetAttachment-Antwortbeispiel

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetAttachment-Anforderung. In diesem Beispiel wird eine Dateianlage zurückgegeben.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="662" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <GetAttachmentResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                           xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:GetAttachmentResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Attachments>
            <t:FileAttachment>
              <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
              <t:Name>SomeFile</t:Name>
              <t:Content>AQIDBAU=</t:Content>
            </t:FileAttachment>
          </m:Attachments>
        </m:GetAttachmentResponseMessage>
      </m:ResponseMessages>
    </GetAttachmentResponse>
  </soap:Body>
</soap:Envelope>

Kommentare

Die Antwortnachrichten für GetAttachment enthalten immer die vollständige Anlage. Das heißt, alle Eigenschaften werden immer eingeschlossen. Bei Dateianlagen sind diese Eigenschaften Name (AttachmentType), ContentType, ContentId, ContentLocation und Content. Bei Elementanlagen sind diese Eigenschaften Name (AttachmentType), ContentType, ContentId, ContentLocation und alle Eigenschaften des Elements, als ob das AllProperties-Shape in einem GetItem-Aufruf verwendet worden wäre. Wenn das AttachmentShape-Element vorhanden ist, kann eine Consumeranwendung zusätzliche erweiterte Eigenschaften für Elementanlagen anfordern.

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Siehe auch

CreateAttachment-Vorgang

DeleteAttachment-Vorgang