Método IVssBackupComponentsEx2::SetRollForward (vsbackup.h)

Establece el tipo de operación de puesta al día para un componente y especifica el punto de restauración para una operación de puesta al día parcial.

Sintaxis

HRESULT SetRollForward(
  [in] VSS_ID               writerId,
  [in] VSS_COMPONENT_TYPE   ct,
  [in] LPCWSTR              wszLogicalPath,
  [in] LPCWSTR              wszComponentName,
  [in] VSS_ROLLFORWARD_TYPE rollType,
  [in] LPCWSTR              wszRollForwardPoint
);

Parámetros

[in] writerId

Identificador único global (GUID) de la clase writer.

[in] ct

Tipo del componente. Consulte la enumeración VSS_COMPONENT_TYPE para conocer los valores posibles.

[in] wszLogicalPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente. Para obtener más información, vea Ruta de acceso lógica de componentes.

El valor de la cadena que contiene la ruta de acceso lógica usada aquí debe ser el mismo que la cadena que se usó cuando se agregó el componente.

La ruta de acceso lógica puede ser NULL.

No hay restricciones en los caracteres que pueden aparecer en una ruta lógica que no sea NULL .

[in] wszComponentName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del componente.

La cadena no puede ser NULL y debe contener el mismo nombre de componente que la cadena que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante el método IVssBackupComponents::AddComponent .

[in] rollType

Valor de enumeración VSS_ROLLFORWARD_TYPE que indica el tipo de operación de puesta al día que se va a realizar.

[in] wszRollForwardPoint

Cadena de caracteres anchos terminada en NULL que especifica el punto de restauración de puesta al día.

El escritor define el formato de esta cadena y puede ser una marca de tiempo, un número de secuencia de registro (LSN) o cualquier marcador definido por el escritor.

Valor devuelto

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

Valor	Significado
S_OK	El tipo de operación de puesta al día y el punto de restauración se establecieron 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_BAD_STATE	No se llamó a este método durante una operación de restauración.
VSS_E_OBJECT_NOT_FOUND	No se encontró el componente especificado.
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

Solo se puede llamar al método SetRollForward durante una operación de restauración.

Un escritor indica que admite este método estableciendo la marca VSS_BS_ROLLFORWARD_RESTORE en su máscara de esquema de copia de seguridad.

Para obtener más información, vea Establecer opciones de restauración de VSS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssBackupComponentsEx2

IVssComponentEx::GetRollForward

VSS_BACKUP_SCHEMA

VSS_ROLLFORWARD_TYPE