Operación GetSharingFolder
La operación GetSharingFolder obtiene el identificador de carpeta local de una carpeta compartida especificada.
Encabezados SOAP
La operación GetSharingFolder puede usar los encabezados SOAP que se enumeran y describen en la tabla siguiente.
| Header | Elemento | Descripción |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. |
Ejemplo de solicitud GetSharingFolder
Obtención del identificador de carpeta local especificando el elemento SharedFolderId de la carpeta que se comparte
En el ejemplo de código siguiente se muestra cómo formar una solicitud para obtener el identificador de la carpeta local que corresponde a la carpeta que se comparte. La carpeta que se comparte se identifica mediante la dirección SMTP del buzón de correo que contiene la carpeta que se comparte y por el elemento SharedFolderId que representa el identificador de esa carpeta. En este ejemplo, la carpeta que se comparte es propiedad de user1@contoso.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="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:GetSharingFolder>
<m:SmtpAddress>user1@contoso.com</m:SmtpAddress>
<m:SharedFolderId>AAMkA=</m:SharedFolderId>
</m:GetSharingFolder>
</soap:Body>
</soap:Envelope>
Obtención del identificador de carpeta local especificando el elemento DataType de la carpeta que se comparte
En el ejemplo de código siguiente se muestra cómo formar una solicitud para obtener el identificador de la carpeta local que corresponde a la carpeta que se comparte. La carpeta que se comparte se identifica mediante la dirección SMTP del buzón de correo que contiene la carpeta que se comparte y por el elemento DataType que representa el tipo de datos de esa carpeta. En este ejemplo, la carpeta que se comparte es la carpeta Contactos que es propiedad de user1@contoso.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="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:GetSharingFolder>
<m:SmtpAddress>user1@contoso.com</m:SmtpAddress>
<m:DataType>Contacts</m:DataType>
</m:GetSharingFolder>
</soap:Body>
</soap:Envelope>
Comentarios
Para obtener información sobre los posibles valores del elemento DataType , vea DataType.
Respuesta getSharingFolder correcta
Descripción
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud GetSharingFolder . El atributo Id del elemento SharingFolderId representa el identificador de la carpeta local en la relación de uso compartido.
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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetSharingFolderResponseMessage 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</m:ResponseCode>
<m:SharingFolderId Id="AAMkAD=" ChangeKey="AwAAA=" />
</GetSharingFolderResponseMessage>
</soap:Body>
</soap:Envelope>
Respuesta de error GetSharingFolder
Descripción
En el ejemplo siguiente se muestra una respuesta de error a una solicitud GetSharingFolder . En este ejemplo, se produjo el error porque la solicitud especificó los elementos SharingFolderId y DataType . Tenga en cuenta que solo se puede especificar uno o el otro de esos dos elementos, pero no ambos.
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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetSharingFolderResponseMessage 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>Either DataType or SharedFolderId must be specified, but not both.</m:MessageText>
<m:ResponseCode>ErrorInvalidGetSharingFolderRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</GetSharingFolderResponseMessage>
</soap:Body>
</soap:Envelope>
Vea también
GetSharingFolderResponseMessage