SendItem-Vorgang

  • Artikel

Der SendItem-Vorgang wird verwendet, um E-Mail-Nachrichten zu senden, die sich im Exchange-Speicher befinden.

SendItem-Anforderungsbeispiel (E-Mail-Nachricht)

Beschreibung

Im folgenden Beispiel wird das Senden einer E-Mail-Nachricht veranschaulicht.

Code

<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>
    <SendItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
              SaveItemToFolder="true">
      <ItemIds>
        <t:ItemId Id="AAAtAEF=" ChangeKey="CQAAABY+T" />
      </ItemIds>
    </SendItem>
  </soap:Body>
</soap:Envelope>

Kommentare

Der Elementbezeichner wurde gekürzt, um die Lesbarkeit zu erhalten.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Erfolgreiche SendItem-Antwort (E-Mail-Nachricht)

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche SendItem-Antwort.

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="602" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SendItemResponse 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:SendItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
        </m:SendItemResponseMessage>
      </m:ResponseMessages>
    </SendItemResponse>
  </soap:Body>
</soap:Envelope>

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Kommentare

Ein Delegat, der versucht, eine E-Mail-Nachricht zu senden, die sich im Ordner "Entwürfe" des Prinzipals befindet, wobei die Option SendAndSaveCopy zum Speichern einer Kopie im Ordner "Gesendete Elemente" festgelegt ist, kann eine Kopie des gesendeten Elements im Hintergrund nicht in den Ordner "Gesendete Elemente" verschoben werden. Das Element verbleibt im Ordner Entwürfe des Prinzipals. Die Problemumgehung besteht darin, das Postfach des Prinzipals im DistinguishedFolderId-Element anzugeben.

Ein weiteres Szenario ist, wenn ein Delegat eine E-Mail-Nachricht erstellt und im Ordner Entwürfe des Postfachs des Delegaten speichert. Wenn der Delegat versucht, das Element zu senden und eine Kopie im Ordner "Gesendete Elemente" des Prinzipals zu speichern, wird die Nachricht ordnungsgemäß gesendet, der Nachrichtenentwurf verbleibt im Ordner "Entwürfe" des Delegaten, die gesendete Nachricht wird weder im Ordner 'Gesendete Elemente' des Delegaten noch im Prinzipal angezeigt, und die Antwort ist erfolgreich.

Beispiel für eine ungültige SendItem-Anforderung (E-Mail-Nachricht)

Beschreibung

Das folgende Codebeispiel zeigt ein Beispiel für eine Anforderung mit einem ungültigen Bezeichner.

Code

<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>
    <SendItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
              SaveItemToFolder="true">
      <ItemIds>
        <t:ItemId Id="%BadItemId%" ChangeKey="CQAAABYAAA" />
      </ItemIds>
    </SendItem>
  </soap:Body>
</soap:Envelope>

SendItem-Fehlerantwort (E-Mail-Nachricht)

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort auf eine SendItem-Anforderung, die einen ungültigen Bezeichner enthält.

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="602" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SendItemResponse 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:SendItemResponseMessage ResponseClass="Error">
          <m:MessageText>Id is malformed.</m:MessageText>
          <m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:SendItemResponseMessage>
      </m:ResponseMessages>
    </SendItemResponse>
  </soap:Body>
</soap:Envelope>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

Siehe auch

SendItem-Vorgang

SendItemType