Método IVssComponent::GetDirectedTarget (vswriter.h)

El método GetDirectedTarget devuelve información almacenada por un escritor, en tiempo de copia de seguridad, en el documento componentes de copia de seguridad para indicar que, cuando se va a restaurar un archivo, se debe reasignar (el archivo de origen). El archivo se puede restaurar en un nuevo destino de restauración o intervalos de sus datos restaurados en diferentes ubicaciones con el destino de restauración.

Un escritor o un solicitante pueden llamar a este método.

Sintaxis

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

Parámetros

[in] iDirectedTarget

Número de índice del destino dirigido. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de destinos dirigidos asociados a un componente determinado (y sus subcomponentes si define un conjunto de componentes). IVssComponent::GetDirectedTargetCount devuelve el valor de n.

[out] pbstrSourcePath

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene la ruta de acceso al directorio que en el momento de la copia de seguridad contenía el archivo que se va a restaurar (el archivo de origen). Esta ruta de acceso debe coincidir o estar debajo de la ruta de acceso de un conjunto de archivos ya en el componente o en uno de sus subcomponentes (si el componente define un conjunto de componentes).

[out] pbstrSourceFileName

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene el nombre del archivo (en tiempo de copia de seguridad) que se va a reasignar durante una restauración (el archivo de origen). El nombre de este archivo no debe contener ningún carácter comodín y debe ser miembro del mismo conjunto de archivos que la ruta de acceso de origen (pbstrSourcePath).

[out] pbstrSourceRangeList

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene una lista separada por comas de desplazamientos y longitudes de archivo que indican el intervalo de compatibilidad del archivo de origen (las secciones del archivo que se van a restaurar).

El número y la longitud de los intervalos de compatibilidad del archivo de origen deben coincidir con el número y el tamaño de los intervalos de compatibilidad de archivos de destino.

[out] pbstrDestinationPath

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene la ruta de acceso a la que se reasignarán los datos del archivo de origen en el momento de la restauración.

[out] pbstrDestinationFilename

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene el nombre del archivo al que se reasignarán los datos del archivo de origen en el momento de la restauración.

[out] pbstrDestinationRangeList

Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene una lista separada por comas de desplazamientos y longitudes de archivo que indican el intervalo de compatibilidad del archivo de destino (ubicaciones a las que se restaurarán las secciones del archivo de origen).

El número y la longitud de los intervalos de compatibilidad de archivos de destino deben coincidir con el número y el tamaño de los intervalos de compatibilidad de archivos de origen.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor	Significado
S_OK	Se devolvió correctamente el valor del atributo.
E_INVALIDARG	Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY	El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT	El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, vea Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND	No se encontró el elemento especificado.

Comentarios

Si la llamada a GetDirectedTarget es correcta, el autor de la llamada es responsable de liberar cada cadena devuelta llamando a la función SysFreeString .

Un solicitante usará la información de destino dirigida almacenada en el documento Componentes de copia de seguridad solo si el destino de restauración está VSS_RT_DIRECTED.

La sintaxis de la lista de intervalos (wszSourceRanges y wszDestinationRanges) es la de una lista separada por comas del formulario offset1:length1, offset2:length2, donde cada desplazamiento y longitud es un entero de 64 bits que especifica un desplazamiento de bytes y una longitud en bytes, respectivamente. El desplazamiento y la longitud se pueden expresar como valores hexadecimales o decimales.

Los archivos cuyos destinos dirigidos son devueltos por GetDirectedTarget pueden ser miembros de los archivos del componente actual o cualquier subcomponente que defina.

El autor de la llamada debe liberar la memoria mantenida por los parámetros pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename y pbstrDestinationRangeList llamando a SysFreeString.

Los archivos parciales se pueden agregar como destinos dirigidos, si los intervalos de archivos parciales de los que se va a realizar una copia de seguridad coinciden con los intervalos de origen de destino dirigidos (vea IVssComponent::AddPartialFile). Esto le permitirá reasignar archivos parciales.

El solicitante deberá comprobar si se ha realizado una copia de seguridad del archivo de origen de destino dirigido como un archivo parcial para implementar correctamente la restauración. Si este es el caso, el solicitante usa la información de destino dirigida junto con la información de archivo parcial (IVssComponent::GetPartialFile) para implementar la reasignación de los datos de copia de seguridad durante la restauración.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vswriter.h (incluye Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssComponent

IVssComponent::AddDirectedTarget

IVssComponent::GetDirectedTargetCount