Compartir a través de

Método IVssCreateExpressWriterMetadata::SetRestoreMethod (vswriter.h)

  • Artículo

Especifica cómo se van a restaurar los datos de un escritor rápido.

Sintaxis

HRESULT SetRestoreMethod(
  [in] VSS_RESTOREMETHOD_ENUM method,
  [in] LPCWSTR                wszService,
  [in] LPCWSTR                wszUserProcedure,
  [in] VSS_WRITERRESTORE_ENUM writerRestore,
  [in] bool                   bRebootRequired
);

Parámetros

[in] method

Valor de enumeración VSS_RESTOREMETHOD_ENUM que especifica el método de restauración que se usará en la operación de restauración. Este parámetro es necesario y no se puede VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION ni VSS_RME_CUSTOM.

[in] wszService

Puntero a una cadena de caracteres anchos que contiene el nombre de un servicio que se debe detener antes de una operación de restauración y, a continuación, se inicia después de que se produzca la operación de restauración, si el valor del método es VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START.

Si el valor del método no es VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, este parámetro no se usa y debe establecerse en NULL.

[in] wszUserProcedure

Reservado para uso futuro. El valor de este parámetro siempre debe establecerse en NULL.

[in] writerRestore

Valor de enumeración VSS_WRITERRESTORE_ENUM que especifica si el escritor estará implicado en la restauración de sus datos. Este parámetro debe establecerse en VSS_WRE_NEVER.

[in] bRebootRequired

Valor booleano que indica si se requerirá un reinicio una vez completada la operación de restauración.

Valor devuelto

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

Valor Significado
S_OK
 La operación se realizó correctamente.
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_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

Un escritor rápido solo puede definir un método de restauración. Si el método de restauración no se invalida, todos los componentes del escritor rápido se restaurarán con el mismo método.

Los escritores rápidos invalidan el método de restauración por componente estableciendo un destino de restauración, normalmente al controlar un evento PreRestore (CVssWriter::OnPreRestore).

Es importante tener en cuenta que, a pesar del hecho de que los métodos de restauración se aplican por escritor, los métodos se implementan por componente. Por ejemplo, si el método especificado por el parámetro method es VSS_RME_RESTORE_IF_CAN_REPLACE, todos los archivos del componente se restauran en su ubicación original si todos se pueden reemplazar sin que se produzca un error. De lo contrario, se restauran en su ubicación alternativa si se especifica una.

Un archivo se puede restaurar en una asignación de ubicación alternativa si se cumple alguna de las siguientes condiciones:

  • El método de restauración es VSS_RME_RESTORE_IF_NOT_THERE y una versión del archivo ya está presente en el disco.
  • El método de restauración es VSS_RME_RESTORE_IF_CAN_REPLACE y una versión del archivo está presente en el disco y no se puede reemplazar.
Si no se define ninguna asignación de ubicación alternativa válida, se trata de un error de escritor.

Para obtener más información sobre los métodos de restauración, vea Establecer métodos de restauración de VSS.

Si el método restore es VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, se debe proporcionar el nombre correcto del servicio como argumento wszService . Para obtener información sobre la participación del escritor en la detención y reinicio de los servicios durante una operación de restauración, consulte Detener servicios para restaurar por solicitantes.

Requisitos

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

Consulte también

IVssCreateExpressWriterMetadata