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
GetSharingFolderResponseMessage