Операция GetSharingFolder

Статья
03/29/2023

Операция GetSharingFolder получает идентификатор локальной папки указанной общей папки.

Заголовки SOAP

Операция GetSharingFolder может использовать заголовки SOAP, перечисленные и описанные в следующей таблице.

Header	Элемент	Описание
RequestVersion	RequestServerVersion	Определяет версию схемы для запроса операции.
ServerVersion	ServerVersionInfo	Определяет версию сервера, который ответил на запрос.

Пример запроса GetSharingFolder

Получение идентификатора локальной папки путем указания элемента SharedFolderId папки, к которой предоставлен общий доступ

В следующем примере кода показано, как сформировать запрос на получение идентификатора локальной папки, соответствующей папке, к которой предоставляется общий доступ. Общая папка определяется SMTP-адресом почтового ящика, содержащего папку, к которой используется общий доступ, и элементом SharedFolderId , который представляет идентификатор этой папки. В этом примере папка, к которой предоставляется общий доступ, принадлежит user1@contoso.com.

Код

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

Получение идентификатора локальной папки путем указания элемента DataType общей папки

В следующем примере кода показано, как сформировать запрос на получение идентификатора локальной папки, соответствующей папке, к которой предоставляется общий доступ. Общая папка определяется SMTP-адресом почтового ящика, содержащего папку, к которой предоставляется общий доступ, и элементом DataType , который представляет тип данных в этой папке. В этом примере папка, к которой предоставляется общий доступ, является папкой "Контакты", принадлежащей user1@contoso.com.

Код

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

Сведения о возможных значениях элемента DataType см. в разделе DataType.

Успешный ответ GetSharingFolder

Описание

В следующем примере показан успешный ответ на запрос GetSharingFolder . Атрибут Id элемента SharingFolderId представляет идентификатор локальной папки в связи общего доступа.

Код

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

Описание

В следующем примере показан ответ на ошибку на запрос GetSharingFolder . В этом примере произошла ошибка, так как запрос указал элементы SharingFolderId и DataType . Обратите внимание, что можно указать только один или другой из этих двух элементов, но не оба.

Код

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