Opération GetSharingFolder

Article
03/29/2023

L’opération GetSharingFolder obtient l’identificateur de dossier local d’un dossier partagé spécifié.

En-têtes SOAP

L’opération GetSharingFolder peut utiliser les en-têtes SOAP répertoriés et décrits dans le tableau suivant.

Header	Élément	Description
RequestVersion	RequestServerVersion	Identifie la version du schéma pour la demande d’opération.
ServerVersion	ServerVersionInfo	Identifie la version du serveur qui a répondu à la requête.

Exemple de requête GetSharingFolder

Obtention de l’identificateur de dossier local en spécifiant l’élément SharedFolderId du dossier partagé

L’exemple de code suivant montre comment former une demande pour obtenir l’identificateur du dossier local qui correspond au dossier partagé. Le dossier partagé est identifié par l’adresse SMTP de la boîte aux lettres qui contient le dossier partagé et par l’élément SharedFolderId qui représente l’identificateur de ce dossier. Dans cet exemple, le dossier partagé appartient à 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>

Obtention de l’identificateur de dossier local en spécifiant l’élément DataType du dossier partagé

L’exemple de code suivant montre comment former une demande pour obtenir l’identificateur du dossier local qui correspond au dossier partagé. Le dossier partagé est identifié par l’adresse SMTP de la boîte aux lettres qui contient le dossier partagé et par l’élément DataType qui représente le type de données dans ce dossier. Dans cet exemple, le dossier partagé est le dossier Contacts qui appartient à 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:DataType>Contacts</m:DataType>
    </m:GetSharingFolder>
  </soap:Body>
</soap:Envelope>

Comments

Pour plus d’informations sur les valeurs possibles de l’élément DataType , consultez DataType.

Réponse GetSharingFolder réussie

Description

L’exemple suivant montre une réponse réussie à une requête GetSharingFolder . L’attribut Id de l’élément SharingFolderId représente l’identificateur du dossier local dans la relation de partage.

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>

Réponse d’erreur GetSharingFolder

Description

L’exemple suivant montre une réponse d’erreur à une requête GetSharingFolder . Dans cet exemple, l’erreur s’est produite car la requête a spécifié les éléments SharingFolderId et DataType . Notez que seul un ou l’autre de ces deux éléments peut être spécifié, mais pas les deux.

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>