Contenido del documento de componentes de copia de seguridad

El documento componentes de copia de seguridad se mantiene mediante instancias de la interfazIVssBackupComponents. Esta interfaz también contiene numerosos métodos para controlar las operaciones de copia de seguridad, manipular instantáneas y consultar el estado del sistema. Sin embargo, no toda la información del documento es directamente accesible a través de esta interfaz.

El documento componentes de copia de seguridad consta de varios conjuntos de datos:

• Información sobre qué componentes se incluyeron explícitamente en una operación de copia de seguridad o restauración
• Representación del componente almacenado y la información del escritor
• Información de estado sobre la operación de copia de seguridad y recuperación

Aunque la información del componente está disponible para el solicitante y el escritor, solo el escritor tiene acceso a la información de estado.

Información de inclusión de componentes

El documento Componentes de copia de seguridad contiene una lista de esos componentes incluidos explícitamente en la copia de seguridad y restauración por parte del solicitante. La lista contiene lo siguiente:

• Se incluyen explícitamente componentes seleccionables.

  La inclusión de estos archivos en las operaciones de copia de seguridad se indica mediante IVssBackupComponents::AddComponent y en las operaciones de restauración mediante IVssBackupComponents::SetSelectedForRestore.

• No seleccionable para subcomponentes de copia de seguridad sin que se pueda seleccionar para el antecesor del componente de copia de seguridad.

  Todos estos componentes deben incluirse si alguno de los componentes del sistema de escritura debe incluirse en la operación. La inclusión de estos archivos en las operaciones de copia de seguridad se indica mediante IVssBackupComponents::AddComponent y en las operaciones de restauración mediante IVssBackupComponents::SetSelectedForRestore.

• Los componentes agregados implícitamente a la copia de seguridad (subcomponentes) que se pueden seleccionar para restaurar y se agregan explícitamente a la restauración.

  Estos componentes pueden ser seleccionables o no seleccionables, pero tienen un antecesor seleccionable que se usó para seleccionarlos implícitamente para la copia de seguridad. Se agregan al documento componentes de copia de seguridad mediante IVssBackupComponents::AddRestoreSubcomponent.

Las identidades de los componentes que se incluyen implícitamente en la restauración no se almacenan en el documento Componentes de copia de seguridad.

VSS tiene acceso a información sobre la inclusión de componentes: los escritores sin componentes incluidos explícitamente en una restauración o copia de seguridad no reciben ningún evento vsS después de la generación de los eventosdePrepareForBackup o preRestore.

Los escritores no pueden consultar directamente esta información. Esto no es una limitación significativa porque, por diseño, los escritores de VSS individuales no deben requerir información detallada sobre el estado de otros escritores en el sistema y, como se indicó anteriormente, los que no tienen componentes incluidos no tendrán que participar en la operación de VSS.

Un solicitante puede determinar qué componentes se han incluido explícitamente en una operación.

El método IVssBackupComponents::GetWriterComponentsCount devuelve el número de escritores con información de componentes almacenada en el documento Componentes de copia de seguridad (y no el número de componentes del documento).

El solicitante indexa a través de la información del escritor almacenado mediante IVssBackupComponents::GetWriterComponents, que devuelve instancias de la interfaz IVssWriterComponentsExt. La interfaz IVssWriterComponentsExt permite al solicitante obtener elde clase de escritura dey instancia de escritor de escritores participantes, así como obtener acceso a información sobre los componentes almacenados en el documento componentes de copia de seguridad.

Información sobre los componentes incluidos

Representación del documento componentes de copia de seguridad de los datos del componente (que no incluye información de ruta de acceso y especificación de archivo), a la que se accede a través de instancias de la interfaz IVssComponent.

Los solicitantes y escritores obtienen acceso a instancias de la interfaz IVssComponent de diferentes maneras.

Un solicitante examina los datos de componentes en un escritor por escritor mediante instancias de la interfaz IVssWriterComponentsExt devuelta por IVssBackupComponents::GetWriterComponents.

Además de la información de identificación del escritor, la interfaz IVssWriterComponentsExt proporciona una matriz de instancias de la interfaz de IVssComponent, una para cada uno de los componentes seleccionados incluidos en los escritores.

Como se indica en ciclo de vida del documento componentes de copia de seguridad, los escritores pueden obtener acceso a la misma información a través del IVssWriterComponents interfaz al controlar el evento PrepareForBackup, PrepareForSnapshot, PostSnapshot, BackupComplete, PreRestore o PostRestore.

IVssComponent permite que tanto el escritor como los solicitantes obtengan la siguiente información:

• Nombre, tipo y ruta de acceso lógica de un componente (GetComponentName, GetComponentType, GetLogicalPath)
• Cómo se debe restaurar un componente como se indica en la de destino de restauración de (IVssComponent::GetRestoreTarget)
• Si se usó una ubicación alternativa para restaurar un archivo (GetAlternateLocationMapping, GetAlternateLocationMappingCount)
• Nueva información de destino, si existe (GetNewTarget, GetNewTargetCount)
• Mensajes de error anteriores y posteriores a la restauración (GetPreRestoreFailureMsg, GetPostRestoreFailureMsg)
• Si se ha seleccionado un para la copia de seguridad componente que define un conjunto de componentes para la restauración (IsSelectedForRestore)
• Si una copia de seguridad o restauración se realizó correctamente (GetBackupSucceededed, GetFileRestoreStatus)
• Cualquier opción de copia de seguridad o restauración específica del escritor que IVssBackupComponents::SetBackupOptions o IVssBackupComponents::SetRestoreOptions (GetBackupOptions, GetRestoreOptions)
• Cualquier copia de seguridad o restauración de metadatos específicos del escritor (GetBackupMetadata), GetRestoreMetadata)
• Información de marca de tiempo (GetBackupStamp, GetPreviousBackupStamp)
• Información sobre los subcomponentes de copia de seguridad incluidos explícitamente en una restauración (GetRestoreSubcomponent, GetRestoreSubcomponentCount)

A diferencia de los solicitantes, los escritores pueden cambiar cierta información en el documento componentes de copia de seguridad a través de la interfaz IVssComponent:

• Cómo se debe restaurar un componente como se indica en el destino de restauración (IVssComponent::SetRestoreTarget)
• Metadatos de copia de seguridad y restauración específicos del escritor (IVssComponent::SetBackupMetadata, IVssComponent::SetRestoreMetadata)
• Información de marca de tiempo (SetBackupStamp)
• Mensajes de error previos y posteriores a la restauración (SetPreRestoreFailureMsg, SetPostRestoreFailureMsg)

Información de estado del solicitante

Los solicitantes insertan información sobre el estado de una operación de copia de seguridad o restauración en el documento Componentes de copia de seguridad mediante la interfazdeIVssBackupComponents. Las aplicaciones de escritura pueden consultar esta información a través de la claseCVssWriter.

La información de estado almacenada en el documento Componentes de copia de seguridad incluye lo siguiente:

Información general sobre la copia de seguridad

• Tipo de copia de seguridad general (incremental, diferencial o completo)

Establecer por solicitantes mediante IVssBackupComponents::SetBackupState

Establecer por solicitantes mediante IVssBackupComponents::SetBackupState

Recuperado por escritores mediante CVssWriter::AreComponentsSelected

Establecer por solicitantes mediante IVssBackupComponents::SetBackupState

Recuperado por escritores mediante CVssWriter::IsBootableStateBackedUp

Establecer por solicitantes mediante IVssBackupComponents::SetBackupState

Recuperado por escritores mediante CVssWriter::IsPartialFileSupportEnabled

Información general sobre la restauración

• El tipo de restauración general (si la restauración es por copia o importación)

Establecer por solicitantes mediante IVssBackupComponents::SetRestoreState

Información sobre los archivos auxiliares

• Ubicación de los archivos de intervalos utilizados por un componente específico en operaciones parciales de archivos

Establecer por solicitantes mediante IVssBackupComponents::SetRangesFilePath

Estado de la información

• Indica si se ha realizado correctamente una copia de seguridad de uno de los componentes de un escritor determinado.

Establecer por solicitantes mediante IVssBackupComponents::SetBackupSucceededed

Establecer por solicitantes mediante IVssBackupComponents::SetFileRestoreStatus

Recuperado por escritores y solicitante mediante IVssComponent::GetFileRestoreStatus

información de Writer-Settable

• Especificación de copia de seguridad adicional para uno de los componentes de un escritor determinado

Establecer por escritores mediante IVssComponent::SetBackupMetadata

Establecer por escritores mediante IVssComponent::SetRestoreMetadata

Recuperado por escritores y solicitantes mediante IVssComponent::GetRestoreMetadata

Establecer por escritores mediante IVssComponent::SetBackupStamp

Recuperado por escritores y solicitantes mediante IVssComponent::GetBackupStamp

Almacenado y establecido por solicitantes para un componente específico mediante IVssBackupComponents::SetPreviousBackupStamp

Recuperado por escritores y solicitantes mediante IVssComponent::GetPreviousBackupStamp

Se establece mediante escritores que usan IVssComponent::SetPreRestoreFailureMsg o IVssComponent::SetPostRestoreFailureMsg

Recuperado por escritores y solicitantes mediante IVssComponent::GetPreRestoreFailureMsg o IVssComponent::GetPostRestoreFailureMsg