GetSharingMetadata-Vorgang
Der GetSharingMetadata-Vorgang ruft ein nicht transparentes Authentifizierungstoken ab, das eine Freigabeseinladung identifiziert.
SOAP-Header
Der GetSharingMetadata-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt und beschrieben werden.
| Header | Element | Beschreibung |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Gibt die Schemaversion für die Vorgangsanforderung an. |
| ServerVersion |
ServerVersionInfo |
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. |
GetSharingMetadata-Anforderungsbeispiel
Beschreibung
Das folgende Beispiel zeigt, wie Sie eine Anforderung zum Abrufen eines nicht transparenten Authentifizierungstokens erstellen, das eine Freigabeseinladung identifiziert. In diesem Beispiel möchte den Ordner, der durch das IdOfFolderToShare-Element angegeben wird, user1@contoso.com mit user1@fabikam.com und user2@test.comfreigeben.
Code
<?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>
Kommentare
Das Recipients (ArrayOfSmtpAddressType) -Element enthält ein SmtpAddress-Element für jeden vorgesehenen Empfänger der Freigabeeinladung.
Erfolgreiche GetSharingMetadata-Antwort
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetSharingMetadata-Anforderung . In diesem Beispiel wurden zwei Empfänger in der entsprechenden GetSharingMetadata-Anforderung angegeben: user1@fabrikam.com und user2@test.com.
Code
<?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>
Kommentare
Die Antwort enthält ein EncryptedSharedFolderData-Element für jede Organisation, die durch gültige Empfänger dargestellt wird, die in der GetSharingMetadata-Anforderung angegeben sind.
Die GetSharingMetadata-Anforderung ist auch dann erfolgreich, wenn in der Anforderung ungültige Empfänger angegeben sind. Das InvalidRecipients-Element enthält Informationen zu ungültigen Empfängern. Informationen zu den Gründen, warum ein Empfänger möglicherweise ungültig ist, finden Sie unter ResponseCode (InvalidRecipientResponseCodeType).
Wenn alle beabsichtigten Empfänger ungültig sind, ist das EncryptedSharedFolderDataCollection-Element leer.
GetSharingMetadata-Fehlerantwort
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetSharingMetadata-Anforderung .
Code
<?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>
Siehe auch
GetSharingMetadataResponseMessage