Operación GetSharingMetadataGetSharingMetadata operation

La operación GetSharingMetadata obtiene un token de autenticación opaco que identifica una invitación de uso compartido.The GetSharingMetadata operation gets an opaque authentication token that identifies a sharing invitation.

Encabezados SOAPSOAP Headers

La operación GetSharingMetadata puede usar los encabezados SOAP que se enumeran y describen en la siguiente tabla.The GetSharingMetadata operation can use the SOAP headers that are listed and described in the following table.

HeaderHeader ElementoElement DescripciónDescription
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request.

Ejemplo de solicitud GetSharingMetadataGetSharingMetadata request example

DescriptionDescription

En el siguiente ejemplo se muestra cómo crear una solicitud para obtener un token de autenticación opaco que identifique una invitación de uso compartido.The following example shows how to form a request to get an opaque authentication token that identifies a sharing invitation. En este ejemplo, user1@contoso.com desea compartir la carpeta especificada por el elemento IdOfFolderToShare con user1@fabikam.com y user2@test.com.In this example, user1@contoso.com wants to share the folder that is specified by the IdOfFolderToShare element with user1@fabikam.com and user2@test.com.

CódigoCode

<?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>

ComentariosComments

El elemento Recipients (ArrayOfSmtpAddressType) contiene un elemento SmtpAddress para cada destinatario previsto de la invitación para uso compartido.The Recipients (ArrayOfSmtpAddressType) element contains one SmtpAddress element for each intended recipient of the sharing invitation.

Respuesta GetSharingMetadata correctaSuccessful GetSharingMetadata Response

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud GetSharingMetadata .The following example shows a successful response to a GetSharingMetadata request. En este ejemplo, se han especificado dos destinatarios en la solicitud GetSharingMetadata correspondiente: user1@fabrikam.com y user2@test.com.In this example, two recipients were specified in the corresponding GetSharingMetadata request: user1@fabrikam.com and user2@test.com.

CódigoCode

<?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>

ComentariosComments

La respuesta contiene un elemento EncryptedSharedFolderData para cada organización representada por destinatarios válidos que se especifican en la solicitud GetSharingMetadata .The response contains one EncryptedSharedFolderData element for each organization that is represented by valid recipients that are specified in the GetSharingMetadata request.

La solicitud GetSharingMetadata se realizará correctamente incluso si se especifican destinatarios no válidos en la solicitud.The GetSharingMetadata request will succeed even if invalid recipients are specified in the request. El elemento InvalidRecipients contiene información sobre los destinatarios no válidos.The InvalidRecipients element contains information about invalid recipients. Para obtener información sobre los motivos por los que un destinatario podría no ser válido, vea ResponseCode (InvalidRecipientResponseCodeType).For information about the reasons why a recipient might be invalid, see ResponseCode (InvalidRecipientResponseCodeType).

Si todos los destinatarios previstos no son válidos, el elemento EncryptedSharedFolderDataCollection estará vacío.If all intended recipients are invalid, the EncryptedSharedFolderDataCollection element will be empty.

Respuesta de error de GetSharingMetadataGetSharingMetadata error response

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta de error a una solicitud GetSharingMetadata .The following example shows an error response to a GetSharingMetadata request.

CódigoCode

<?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>

Vea tambiénSee also

GetSharingMetadataGetSharingMetadata

GetSharingMetadataTypeGetSharingMetadataType

GetSharingMetadataResponseMessageGetSharingMetadataResponseMessage

GetSharingMetadataResponseMessageTypeGetSharingMetadataResponseMessageType

Operaciones de EWS en ExchangeEWS operations in Exchange