GetSharingMetadata 操作
GetSharingMetadata 操作は、共有の招待を識別する不透明な認証トークンを取得します。
SOAP ヘッダー
GetSharingMetadata 操作では、次の表に記載されている SOAP ヘッダーを使用できます。
| Header | 要素 | 説明 |
|---|---|---|
| RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 |
| ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 |
GetSharingMetadata 要求の例
説明
次の例は、共有の招待を識別する不透明な認証トークンを取得する要求を形成する方法を示しています。 この例では、 user1@contoso.comIdOfFolderToShare 要素で指定されたフォルダーを と user2@test.comでuser1@fabikam.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) 要素には、共有招待の目的の受信者ごとに 1 つの SmtpAddress 要素が含まれています。
GetSharingMetadata 応答の成功
説明
次の例は、 GetSharingMetadata 要求に対する正常な応答を示しています。 この例では、対応する GetSharingMetadata 要求 user1@fabrikam.comuser2@test.comと で 2 つの受信者を指定しました。
コード
<?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
応答には、GetSharingMetadata 要求で指定された有効な受信者によって表される組織ごとに 1 つの EncryptedSharedFolderData 要素が含まれています。
要求で無効な受信者が指定されている場合でも、 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