Operação GetSharingMetadata
A operação GetSharingMetadata obtém um token de autenticação opaca que identifica um convite de compartilhamento.
Cabeçalhos SOAP
A operação GetSharingMetadata 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 GetSharingMetadata
Descrição
O exemplo a seguir mostra como formar uma solicitação para obter um token de autenticação opaca que identifica um convite de compartilhamento. Neste exemplo, user1@contoso.com deseja compartilhar a pasta especificada pelo elemento IdOfFolderToShare com user1@fabikam.com e user2@test.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="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:GetSharingMetadata>
<m:IdOfFolderToShare Id="AAMkAD=" ChangeKey="AwAAA=" />
<m:SenderSmtpAddress>user1@contoso.com</m:SenderSmtpAddress>
<m:Recipients>
<t:SmtpAddress>user1@fabrikam.com</t:SmtpAddress>
<t:SmtpAddress>user2@test.com</t:SmtpAddress>
</m:Recipients>
</m:GetSharingMetadata>
</soap:Body>
</soap:Envelope>
Comments
O elemento Destinatários (ArrayOfSmtpAddressType)contém um elemento SmtpAddress para cada destinatário pretendido do convite de compartilhamento.
Resposta GetSharingMetadata bem-sucedida
Descrição
O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação GetSharingMetadata . Neste exemplo, dois destinatários foram especificados na solicitação GetSharingMetadata correspondente: user1@fabrikam.com e user2@test.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">
<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>
<GetSharingMetadataResponseMessage 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</ResponseCode>
<m:EncryptedSharedFolderDataCollection>
<t:EncryptedSharedFolderData>
<t:Token>
<EncryptedData Id="Assertion0" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns="http://www.w3.org/2001/04/xmlenc#">
<EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#tripledes-cbc"></EncryptionMethod>
<ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<EncryptedKey>
<EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p"></EncryptionMethod>
<ds:KeyInfo Id="keyinfo">
<wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:KeyIdentifier
EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"
ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier">
B4VEEAf=
</wsse:KeyIdentifier>
</wsse:SecurityTokenReference>
</ds:KeyInfo>
<CipherData>
<CipherValue>GI/Dxqvw2na==</CipherValue>
</CipherData>
</EncryptedKey>
</ds:KeyInfo>
<CipherData>
<CipherValue>L77I7Hr06z</CipherValue>
</CipherData>
</EncryptedData>
</t:Token>
<t:Data>
<EncryptedData Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns="http://www.w3.org/2001/04/xmlenc#">
<EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc" />
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<EncryptedKey xmlns="http://www.w3.org/2001/04/xmlenc#">
<EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#kw-tripledes" />
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<KeyName>key</KeyName>
</KeyInfo>
<CipherData>
<CipherValue>9UgtjrHiU</CipherValue>
</CipherData>
</EncryptedKey>
</KeyInfo>
<CipherData>
<CipherValue>NCNsJoGtQ==</CipherValue>
</CipherData>
</EncryptedData>
</t:Data>
</t:EncryptedSharedFolderData>
</m:EncryptedSharedFolderDataCollection>
<m:InvalidRecipients>
<t:InvalidRecipient>
<t:SmtpAddress>user2@test.com</t:SmtpAddress>
<t:ResponseCode>RecipientOrganizationNotFederated</t:ResponseCode>
<m:MessageText>The organization of these recipients is not federated for external sharing.</m:MessageText>
</t:InvalidRecipient>
</m:InvalidRecipients>
</GetSharingMetadataResponseMessage>
</soap:Body>
</soap:Envelope>
Comments
A resposta contém um elemento EncryptedSharedFolderData para cada organização representada por destinatários válidos especificados na solicitação GetSharingMetadata .
A solicitação GetSharingMetadata será bem-sucedida mesmo se os destinatários inválidos forem especificados na solicitação. O elemento InvalidRecipients contém informações sobre destinatários inválidos. Para obter informações sobre os motivos pelos quais um destinatário pode ser inválido, consulte ResponseCode (InvalidRecipientResponseCodeType).
Se todos os destinatários pretendidos forem inválidos, o elemento EncryptedSharedFolderDataCollection estará vazio.
Resposta de erro GetSharingMetadata
Descrição
O exemplo a seguir mostra uma resposta de erro a uma solicitação GetSharingMetadata .
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="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetSharingMetadataResponseMessage 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>The SMTP address format is invalid.</MessageText>
<m:ResponseCode>ErrorInvalidSmtpAddress</ResponseCode>
<m:DescriptiveLinkKey>0</DescriptiveLinkKey>
</GetSharingMetadataResponseMessage>
</soap:Body>
</soap:Envelope>
Confira também
GetSharingMetadataResponseMessage
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de