GetSharingFolder-Vorgang

Artikel
03/29/2023

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="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://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="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetSharingFolderResponseMessage ResponseClass="Success"
                                xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
                                xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
                                xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetSharingFolderResponseMessage ResponseClass="Error" 
                                xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
                                xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
                                xmlns="https://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>