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

El método AddDirectedTarget permite que un escritor indique en el momento de la restauración que, cuando se va a restaurar un archivo, se debe reasignar (el archivo de origen). El archivo se puede restaurar en una nueva ubicación de restauración o intervalos de sus datos restaurados en diferentes desplazamientos dentro de la ubicación de restauración.

Un escritor solo puede llamar a este método durante una operación de restauración.

No se puede llamar a este método mientras se controla un evento BackupComplete (CVssWriter::OnBackupComplete) o BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaxis

HRESULT AddDirectedTarget(
  [in] LPCWSTR wszSourcePath,
  [in] LPCWSTR wszSourceFilename,
  [in] LPCWSTR wszSourceRangeList,
  [in] LPCWSTR wszDestinationPath,
  [in] LPCWSTR wszDestinationFilename,
  [in] LPCWSTR wszDestinationRangeList
);

Parámetros

[in] wszSourcePath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso al directorio en tiempo de restauración que contiene 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 uno de sus subcomponentes si el componente define un conjunto de componentes).

[in] wszSourceFilename

Cadena de caracteres anchos terminada en NULL que contiene el nombre del archivo (en tiempo de copia de seguridad) que se reasignará en el momento de la restauración (el archivo de origen). El nombre del archivo (wszSourceFilename) no puede contener caracteres comodín (* o ?) y debe ser coherente con la especificación de archivo de un conjunto de archivos que contiene la ruta de acceso de origen (wszSourcePath).

[in] wszSourceRangeList

Cadena de caracteres anchos terminada en NULL 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 realmente).

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

[in] wszDestinationPath

Cadena de caracteres anchos terminada en NULL 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.

[in] wszDestinationFilename

Cadena de caracteres anchos terminada en NULL que contiene el nombre del archivo al que se reasignarán los datos del archivo de origen en el momento de la restauración. El nombre del archivo (wszDestinationFilename) no puede contener caracteres comodín (* o ?).

[in] wszDestinationRangeList

Cadena de caracteres anchos terminada en NULL 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 van a restaurar 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	Establezca correctamente el elemento.
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_BAD_STATE	Un escritor no llamó a este método o, si lo llama un escritor, no se llamó durante una operación de restauración o al controlar un evento BackupComplete o BackupShutdown .

Comentarios

Solo un escritor puede llamar a AddDirectedTarget y solo durante las operaciones de restauración.

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 es VSS_RT_DIRECTED.

El método AddDirectedTarget se puede aplicar a cualquier archivo administrado en el componente actual o, si el componente define un conjunto de componentes, en cualquiera de sus subcomponentes no seleccionables.

Las especificaciones del archivo de origen y de destino pueden apuntar al mismo archivo. Esto permitiría reasignar un archivo en sí mismo en el momento de la restauración.

La sintaxis de la lista de intervalos (wszSourceRanges y wszDestinationRanges) es la de una lista separada por comas de la forma 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.

El número de entradas y sus tamaños deben coincidir en los argumentos de intervalo de origen y destino.

AddDirectedTarget puede usar como archivo de origen cualquier archivo ya administrado por el componente o uno de sus subcomponentes si el componente define un conjunto de componentes.

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 (consulte IVssComponent::AddPartialFile). Esto le permitirá reasignar archivos parciales en el momento de la restauración.

En este caso, el solicitante recupera la información de destino dirigida llamando al método IVssComponent::GetDirectedTarget y lo usa 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 (incluya Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssComponent

IVssComponent::GetDirectedTarget

IVssComponent::GetDirectedTargetCount