VSS_RESTORE_TARGET enumeración (vswriter.h)

El escritor usa la enumeración VSS_RESTORE_TARGET en el momento de la restauración para indicar cómo se restaurarán todos los archivos incluidos en un componente seleccionado y todos los archivos de cualquier conjunto de componentes que defina. (Consulte Trabajar con la capacidad de selección y las rutas lógicas para obtener información sobre cómo seleccionar componentes).

Establecer un destino de restauración modifica o invalida el conjunto de métodos de restauración durante la copia de seguridad (consulte VSS_RESTOREMETHOD_ENUM).

Syntax

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

Constantes

VSS_RT_UNDEFINED Valor: 0 No se define ningún destino. Este valor indica un error en la parte del escritor. Este valor no se admite para escritores rápidos.
VSS_RT_ORIGINAL Este es el destino de restauración predeterminado. Este valor indica que la restauración de los archivos incluidos en un componente seleccionado (o el conjunto de componentes definido por ese componente) debe continuar según el método de restauración original especificado en el momento de la copia de seguridad. un valor de VSS_RESTOREMETHOD_ENUM .
VSS_RT_ALTERNATE Los archivos se restauran en una ubicación determinada a partir de una asignación de ubicación alternativa existente. El destino de restauración debe establecerse en VSS_RT_ALTERNATE solo cuando la ubicación alternativa Se han establecido asignaciones para todos los archivos administrados por un componente o conjunto de componentes seleccionado. Este valor no se admite para escritores rápidos.
VSS_RT_DIRECTED Use el destino dirigido por el escritor en el momento de la restauración para restaurar un archivo. El destino dirigido permite a un escritor controlar, en un archivo por archivo, cómo es un archivo restaurado: indica la cantidad de un archivo que se va a restaurar y en qué archivos se va a restaurar Se va a restaurar el archivo de copia de seguridad. Este valor no se admite para escritores rápidos.
VSS_RT_ORIGINAL_LOCATION Los archivos se restauran en la ubicación en la que estaban en el momento de la copia de seguridad, incluso si el original método restore que se especificó en el momento de la copia de seguridad VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Windows Server 2003 y Windows XP: Este valor no se admite. Este valor no se admite para escritores rápidos.

Comentarios

Un destino de VSS_RT_UNDEFINED indica un estado de error.

En tiempo de copia de seguridad, los escritores establecen el comportamiento de restauración predeterminado indicando un método de restauración (VSS_RESTOREMETHOD_ENUM) establecido con IVssCreateWriterMetadata::SetRestoreMethod.

Si un escritor no establece explícitamente el destino de restauración de un componente y cualquier conjunto de componentes que define, de forma predeterminada se establece en VSS_RT_ORIGINAL.

En el momento de la restauración, un valor de VSS_RESTORE_TARGET distinto de VSS_RT_ORIGINAL invalida el valor del método de restauración especificado originalmente especificado por VSS_RESTOREMETHOD_ENUM y establecido por IVssCreateWriterMetadata::SetRestoreMethod.

Solo los escritores (con IVssComponent::SetRestoreTarget) pueden establecer un destino de restauración (VSS_RESTORE_TARGET) y cambiar cómo se restauran los archivos reemplazando el método de restauración).

Los solicitantes y escritores pueden acceder al destino de restauración actual a través de IVssComponent::GetRestoreTarget.

Un destino de restauración de VSS_RT_ORIGINAL no significa que los archivos se deben restaurar en su ubicación original, pero que se debe respetar el método de restauración especificado originalmente (VSS_RESTOREMETHOD_ENUM). Por ejemplo, si un escritor establece un método de restauración de VSS_RME_RESTORE_TO_ALTERNATE_LOCATION para un componente seleccionado y el destino de restauración es VSS_RT_ORIGINAL, los archivos deben restaurarse en la ubicación alternativa definida por el escritor.

(En este ejemplo, si un escritor no ha definido asignaciones de ubicación alternativas, se trata de un error de escritor y el solicitante debe notificarlo).

Un destino de restauración de VSS_RT_ALTERNATE sin una asignación de ubicación alternativa definida constituye un error de escritura y el solicitante debe notificarlo como tal.

Consulte Ubicaciones de copia de seguridad y restauración no predeterminadas para obtener más informació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]
Encabezado	vswriter.h

Consulte también

IVssComponent::GetRestoreTarget

IVssComponent::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM