Операция GetSharingMetadata
Операция GetSharingMetadata получает непрозрачный маркер проверки подлинности, который идентифицирует приглашение общего доступа.
Заголовки SOAP
Операция GetSharingMetadata может использовать заголовки SOAP, перечисленные и описанные в следующей таблице.
| Header | Элемент | Описание |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Определяет версию схемы для запроса операции. |
| ServerVersion |
ServerVersionInfo |
Определяет версию сервера, который ответил на запрос. |
Пример запроса GetSharingMetadata
Описание
В следующем примере показано, как сформировать запрос на получение непрозрачного маркера проверки подлинности, который идентифицирует приглашение общего доступа. В этом примере требуется предоставить общий доступ к папке, user1@contoso.com указанной элементом IdOfFolderToShare , с user1@fabikam.com и user2@test.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="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: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
Элемент Recipients (ArrayOfSmtpAddressType) содержит один элемент SmtpAddress для каждого предполагаемого получателя приглашения на общий доступ.
Успешный ответ GetSharingMetadata
Описание
В следующем примере показан успешный ответ на запрос GetSharingMetadata . В этом примере в соответствующем запросе GetSharingMetadata были указаны два получателя: user1@fabrikam.com и user2@test.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">
<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>
<GetSharingMetadataResponseMessage 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</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
Ответ содержит один элемент EncryptedSharedFolderData для каждой организации, представленной допустимыми получателями, указанными в запросе GetSharingMetadata .
Запрос GetSharingMetadata будет выполнен успешно, даже если в запросе указаны недопустимые получатели. Элемент InvalidRecipients содержит сведения о недопустимых получателях. Сведения о причинах, по которым получатель может быть недопустимым, см. в разделе ResponseCode (InvalidRecipientResponseCodeType).
Если все предполагаемые получатели недопустимы, элемент EncryptedSharedFolderDataCollection будет пустым.
Ответ на ошибку GetSharingMetadata
Описание
В следующем примере показан ответ на ошибку на запрос GetSharingMetadata .
Код
<?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>
<GetSharingMetadataResponseMessage 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>The SMTP address format is invalid.</MessageText>
<m:ResponseCode>ErrorInvalidSmtpAddress</ResponseCode>
<m:DescriptiveLinkKey>0</DescriptiveLinkKey>
</GetSharingMetadataResponseMessage>
</soap:Body>
</soap:Envelope>
См. также
GetSharingMetadataResponseMessage