Operação SendItemSendItem operation

A operação SendItem é usada para enviar mensagens de email que estão localizadas no repositório do Exchange.The SendItem operation is used to send e-mail messages that are located in the Exchange store.

Exemplo de solicitação SendItem (mensagem de email)SendItem (E-mail Message) request example

DescriçãoDescription

O exemplo a seguir mostra como enviar uma mensagem de email.The following example shows how to send an e-mail message.

CódigoCode

<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>

ComentáriosComments

O identificador de item foi reduzido para preservar a legibilidade.The item identifier has been shortened to preserve readability.

Elementos RequestRequest elements

Os seguintes elementos são usados na solicitação:The following elements are used in the request:

Resposta SendItem (mensagem de email) bem-sucedidaSuccessful SendItem (E-mail Message) Response

DescriçãoDescription

O exemplo a seguir mostra uma resposta SendItem bem-sucedida.The following example shows a successful SendItem response.

CódigoCode

<?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>

Elementos de resposta bem-sucedidosSuccessful response elements

Os seguintes elementos são usados na resposta:The following elements are used in the response:

ComentáriosComments

Um representante que tentar enviar uma mensagem de email que está localizado na pasta Rascunhos da entidade de segurança com a opção SendAndSaveCopy definida para salvar uma cópia na pasta distinta de itens enviados, falhará silenciosamente, para mover uma cópia do item enviado para a pasta distinta itens enviados.A delegate who tries to send an e-mail message that is located in the principal's Drafts folder with the SendAndSaveCopy option set to save a copy in the Sent Items distinguished folder will silently fail to move a copy of the sent item to the Sent Items distinguished folder. O item permanecerá na pasta Rascunhos da entidade de segurança.The item will remain in the principal's Drafts folder. A solução alternativa para esse problema é especificar a caixa de correio da entidade de segurança no elemento DistinguishedFolderId .The workaround for this issue is to specify the principal's mailbox in the DistinguishedFolderId element.

Um cenário adicional a ser considerado é quando um representante cria uma mensagem de email e a salva na pasta Rascunhos da caixa de correio do representante.An additional scenario to consider is when a delegate creates an e-mail message and saves it to the Drafts folder of the delegate's mailbox. Se o representante tentar enviar o item e salvar uma cópia na pasta distinta de itens enviados da entidade de segurança, a mensagem será enviada corretamente, a mensagem de rascunho permanecerá na pasta Rascunhos do representante, a mensagem enviada não aparecerá na pasta Itens enviados do representante ou da entidade de segurança e a resposta será um êxito.If the delegate tries to send the item and save a copy to the principal's Sent Items distinguished folder, the message is sent correctly, the draft message remains in the delegate's Drafts folder, the sent message does not appear in either the delegate's or principal's Sent Items folder, and the response is a success.

Exemplo de solicitação SendItem (mensagem de email) inválidaInvalid SendItem (E-mail Message) request example

DescriçãoDescription

O exemplo de código a seguir mostra um exemplo de uma solicitação com um identificador inválido.The following code sample shows an example of a request with an invalid identifier.

CódigoCode

<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>

Resposta de erro SendItem (mensagem de email)SendItem (E-mail Message) error response

DescriçãoDescription

O exemplo a seguir mostra uma resposta de erro a uma solicitação de SendItem que contém um identificador inválido.The following example shows an error response to a SendItem request that contains an invalid identifier.

CódigoCode

<?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>

Elementos de resposta de erroError response elements

Os seguintes elementos são usados na resposta de erro:The following elements are used in the error response:

Confira tambémSee also

Operação SendItemSendItem operation

SendItemTypeSendItemType