Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der GetItem-Vorgang ermöglicht dem Benutzer den Zugriff auf Informationen über e-Mail-Nachrichten.
Verwenden des GetItem-Vorgangs für Nachrichten
Die GetItem-Anforderung muss über die folgenden Informationen verfügen:
Das ItemID -Element zum Identifizieren der zurückzugebenden Elementinformationen.
Das ItemShape -Element, um die zurückzugebenden Elementeigenschaften zu identifizieren.
GetItem-Anforderungs Beispiel
Beschreibung
Im folgenden Beispiel einer GetItem-Anforderung wird gezeigt, wie auf Informationen zu e-Mail-Nachrichten zugegriffen werden kann.
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>
<GetItem
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ItemShape>
<t:BaseShape>Default</t:BaseShape>
<t:IncludeMimeContent>true</t:IncludeMimeContent>
</ItemShape>
<ItemIds>
<t:ItemId Id="AAAlAF" ChangeKey="CQAAAB" />
</ItemIds>
</GetItem>
</soap:Body>
</soap:Envelope>
Anfordern von Elementen
In der Anforderung werden folgende Elemente verwendet:
Erfolgreiches GetItem (e-Mail-Nachricht)-Antwortbeispiel
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die GetItem-Anforderung.
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="685" MinorBuildNumber="8"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse 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:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Message>
<t:MimeContent CharacterSet="UTF-8">UmVjZWl</t:MimeContent>
<t:ItemId Id="AAAlAFVz" ChangeKey="CQAAAB" />
<t:Subject />
<t:Sensitivity>Normal</t:Sensitivity>
<t:Body BodyType="HTML">
<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta content="MSHTML 6.00.3790.2759" name="GENERATOR">
<style title="owaParaStyle">P { MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px } </style>
</head>
<body ocsi="x">
<div dir="ltr">
<font face="Tahoma" color="#000000" size="2"></font>&nbsp;
</div>
</body>
</html>
</t:Body>
<t:Size>881</t:Size>
<t:DateTimeSent>2006-10-28T01:37:06Z</t:DateTimeSent>
<t:DateTimeCreated>2006-10-28T01:37:06Z</t:DateTimeCreated>
<t:ResponseObjects>
<t:ReplyToItem />
<t:ReplyAllToItem />
<t:ForwardItem />
</t:ResponseObjects>
<t:HasAttachments>false</t:HasAttachments>
<t:ToRecipients>
<t:Mailbox>
<t:Name>User1</t:Name>
<t:EmailAddress>User1@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:ToRecipients>
<t:IsReadReceiptRequested>false</t:IsReadReceiptRequested>
<t:IsDeliveryReceiptRequested>false</t:IsDeliveryReceiptRequested>
<t:From>
<t:Mailbox>
<t:Name>User2</t:Name>
<t:EmailAddress>User2@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:From>
<t:IsRead>false</t:IsRead>
</t:Message>
</m:Items>
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Comments
Die MIME-Inhalte, Ordner und Element-IDs wurden verkürzt, um die Lesbarkeit zu erhalten.
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet:
Fehlerantwort-Beispiel für GetItem (e-Mail-Nachricht)
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetItem-Anforderung. Der Fehler wurde durch einen Versuch verursacht, eine ungültige zusätzliche Eigenschaft abzurufen.
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="685" MinorBuildNumber="8"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse 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:GetItemResponseMessage ResponseClass="Error">
<m:MessageText>Property is not valid for this object type.</m:MessageText>
<m:ResponseCode>ErrorInvalidPropertyRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:FieldURI FieldURI="meeting:AssociatedCalendarItemId" />
</m:MessageXml>
<m:Items />
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Fehlerantwortelemente
Folgende Elemente werden in der Fehlerantwort verwendet: