GetSharingFolder-Vorgang
Der GetSharingFolder-Vorgang ruft den lokalen Ordnerbezeichner eines angegebenen freigegebenen Ordners ab.
SOAP-Header
Der GetSharingFolder-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt und beschrieben werden.
| Header | Element | Beschreibung |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Gibt die Schemaversion für die Vorgangsanforderung an. |
| ServerVersion |
ServerVersionInfo |
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. |
GetSharingFolder-Anforderungsbeispiel
Abrufen des Lokalen Ordnerbezeichners durch Angeben des SharedFolderId-Elements des freigegebenen Ordners
Das folgende Codebeispiel zeigt, wie sie eine Anforderung zum Abrufen des Bezeichners des lokalen Ordners erstellen, der dem freigegebenen Ordner entspricht. Der freigegebene Ordner wird durch die SMTP-Adresse des Postfachs identifiziert, das den freigegebenen Ordner enthält, und durch das SharedFolderId-Element , das den Bezeichner dieses Ordners darstellt. In diesem Beispiel ist der freigegebene Ordner im Besitz von user1@contoso.com.
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"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010"/>
</soap:Header>
<soap:Body>
<m:GetSharingFolder>
<m:SmtpAddress>user1@contoso.com</m:SmtpAddress>
<m:SharedFolderId>AAMkA=</m:SharedFolderId>
</m:GetSharingFolder>
</soap:Body>
</soap:Envelope>
Abrufen des Lokalen Ordnerbezeichners durch Angeben des DataType-Elements des freigegebenen Ordners
Das folgende Codebeispiel zeigt, wie sie eine Anforderung zum Abrufen des Bezeichners des lokalen Ordners erstellen, der dem freigegebenen Ordner entspricht. Der freigegebene Ordner wird durch die SMTP-Adresse des Postfachs, das den freigegebenen Ordner enthält, und durch das DataType-Element identifiziert, das den Datentyp in diesem Ordner darstellt. In diesem Beispiel ist der freigegebene Ordner der Ordner Kontakte, der sich im Besitz von user1@contoso.combefindet.
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"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010"/>
</soap:Header>
<soap:Body>
<m:GetSharingFolder>
<m:SmtpAddress>user1@contoso.com</m:SmtpAddress>
<m:DataType>Contacts</m:DataType>
</m:GetSharingFolder>
</soap:Body>
</soap:Envelope>
Kommentare
Informationen zu den möglichen Werten des DataType-Elements finden Sie unter DataType.
Erfolgreiche GetSharingFolder-Antwort
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetSharingFolder-Anforderung . Das Id-Attribut des SharingFolderId-Elements stellt den Bezeichner des lokalen Ordners in der Freigabebeziehung dar.
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="14"
MinorVersion="0"
MajorBuildNumber="639"
MinorBuildNumber="11"
Version="Exchange2010"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetSharingFolderResponseMessage ResponseClass="Success"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseCode>NoError</m:ResponseCode>
<m:SharingFolderId Id="AAMkAD=" ChangeKey="AwAAA=" />
</GetSharingFolderResponseMessage>
</soap:Body>
</soap:Envelope>
GetSharingFolder-Fehlerantwort
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetSharingFolder-Anforderung . In diesem Beispiel ist der Fehler aufgetreten, weil die Anforderung sowohl das SharingFolderId - als auch das DataType-Element angegeben hat. Beachten Sie, dass nur ein oder das andere dieser beiden Elemente angegeben werden kann, aber nicht beide.
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="14"
MinorVersion="0"
MajorBuildNumber="639"
MinorBuildNumber="11"
Version="Exchange2010"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetSharingFolderResponseMessage ResponseClass="Error"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:MessageText>Either DataType or SharedFolderId must be specified, but not both.</m:MessageText>
<m:ResponseCode>ErrorInvalidGetSharingFolderRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</GetSharingFolderResponseMessage>
</soap:Body>
</soap:Envelope>
Siehe auch
GetSharingFolderResponseMessage