Compartilhar via


Operação GetSharingFolder

A operação GetSharingFolder obtém o identificador de pasta local de uma pasta compartilhada especificada.

Cabeçalhos SOAP

A operação GetSharingFolder pode usar os cabeçalhos SOAP listados e descritos na tabela a seguir.

Header Elemento Descrição
RequestVersion
RequestServerVersion
Identifica a versão do esquema para a solicitação de operação.
Serverversion
ServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.

Exemplo de solicitação GetSharingFolder

Obtendo o identificador de pasta local especificando o elemento SharedFolderId da pasta que está sendo compartilhada

O exemplo de código a seguir mostra como formar uma solicitação para obter o identificador da pasta local que corresponde à pasta que está sendo compartilhada. A pasta que está sendo compartilhada é identificada pelo endereço SMTP da caixa de correio que contém a pasta que está sendo compartilhada e pelo elemento SharedFolderId que representa o identificador dessa pasta. Neste exemplo, a pasta que está sendo compartilhada pertence a user1@contoso.com.

Código

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

Obtendo o identificador de pasta local especificando o elemento DataType da pasta que está sendo compartilhada

O exemplo de código a seguir mostra como formar uma solicitação para obter o identificador da pasta local que corresponde à pasta que está sendo compartilhada. A pasta que está sendo compartilhada é identificada pelo endereço SMTP da caixa de correio que contém a pasta que está sendo compartilhada e pelo elemento DataType que representa o tipo de dados nessa pasta. Neste exemplo, a pasta que está sendo compartilhada é a pasta Contatos que pertence a user1@contoso.com.

Código

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

Comments

Para obter informações sobre os valores possíveis do elemento DataType , consulte DataType.

Resposta getsharingfolder bem-sucedida

Descrição

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação GetSharingFolder . O atributo Id do elemento SharingFolderId representa o identificador da pasta local na relação de compartilhamento.

Código

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

Resposta de erro GetSharingFolder

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação GetSharingFolder . Neste exemplo, o erro ocorreu porque a solicitação especificou os elementos SharingFolderId e DataType . Observe que apenas um ou outro desses dois elementos pode ser especificado, mas não ambos.

Código

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

Confira também

GetSharingFolder

GetSharingFolderType

GetSharingFolderResponseMessage

GetSharingFolderResponseMessageType

Operações EWS no Exchange