Uso de componentes por el solicitante

Además de realizar una copia de seguridad o restauración, y supervisar instantáneas, un solicitante debe administrar información sobre los componentes de los escritores con los que interactúa. La selección de componentes y la ruta de acceso lógica se usan para incluir o excluir datos de una copia de seguridad, y para decidir qué información de componentes se incluye en el documento Componentes de copia de seguridad.

Selección de componentes del solicitante durante la copia de seguridad

Durante las operaciones de copia de seguridad, un solicitante importa datos de componentes de metadatos de escritor mediante los métodos IVssBackupComponents::GatherWriterMetadata e IVssBackupComponents::GetWriterMetadata (consulte Información general sobre la inicialización de copia de seguridad para obtener más información).

Después de examinar la información del escritor con la interfaz IVssExamineWriterMetadata , un solicitante decide qué escritores realizará una copia de seguridad y, en una medida limitada, cuál de los componentes de un escritor determinado hará una copia de seguridad.

Al realizar una copia de seguridad de un escritor, un solicitante:

  • Debe incluir explícitamente todos los componentes no seleccionables de un escritor para los componentes de copia de seguridad sin seleccionar para los antecesores de copia de seguridad mediante IVssBackupComponents::AddComponent para agregar el componente al documento Componentes de copia de seguridad
  • Puede incluir explícitamente cualquiera de los componentes de copia de seguridad seleccionables de un escritor mediante IVssBackupComponents::AddComponent para agregar el componente al documento Componentes de copia de seguridad
  • Si un componente de copia de seguridad seleccionable define un conjunto de componentes, su inclusión explícita incluye implícitamente todos los miembros del conjunto de componentes, tanto si se pueden seleccionar para la copia de seguridad como si no. Estos componentes no se agregan al documento Componentes de copia de seguridad.

Al agregar un componente de copia de seguridad seleccionable o no seleccionable para los componentes de copia de seguridad sin seleccionar para los antecesores de copia de seguridad en su documento componentes de copia de seguridad, un solicitante especifica lo siguiente:

  • Instancia del escritor que administra el componente
  • Identificador de clase del escritor
  • Ruta de acceso lógica del componente (que puede ser NULL)
  • Nombre del componente

Si un componente no coincide con la especificación, se devolverá un error.

Si existe este componente, VSS crea una interfaz IVssComponent para el componente en el documento Componentes de copia de seguridad. El escritor y el solicitante podrán acceder a esta información y modificarla. Para un componente seleccionable que define un conjunto de componentes, describe no solo las propiedades del componente, sino también todos los subcomponentes que contiene.

La información sobre los componentes agregados implícitamente no está disponible en el documento Componentes de copia de seguridad. Además, no hay información de archivo disponible en el documento Componentes de copia de seguridad. Para obtener esa información, el solicitante tendrá que examinar los documentos de metadatos del escritor (que ya se leerán) en el contexto de los componentes almacenados seleccionados en el documento Componentes de copia de seguridad.

Selección de componentes del solicitante durante la restauración

Durante las operaciones de restauración, un solicitante no debe importar información de componentes de los escritores activos actualmente en el sistema a través de IVssBackupComponents::GatherWriterMetadata, ya que el estado de los procesos actualmente en ejecución no reflejará necesariamente el estado de los procesos cuando se realizó una copia de seguridad.

Todavía debe generar un evento Identify a través de IVssBackupComponents::GatherWriterMetadata, tanto para crear un evento Identify como para determinar qué escritores están actualmente en el sistema y su estado.

El solicitante recupera el documento de componentes de copia de seguridad almacenados durante su inicialización, así como los documentos de metadatos de escritor almacenados (vea Información general sobre la inicialización de restauración para obtener más información).

La inclusión de componentes durante la copia de seguridad es en gran medida la misma que para la restauración, salvo que debe considerar la posibilidad de seleccionar para la restauración junto con la ruta de acceso lógica, no se puede seleccionar para la copia de seguridad.

Sin embargo, hay algunas diferencias:

  • Si un componente ya se ha incluido explícitamente en el documento componentes de copia de seguridad durante la copia de seguridad, si se incluye para la restauración (ya sea explícita o implícitamente), se usa IVssBackupComponents::SetSelectedForRestore para agregarlo explícitamente al documento componentes de copia de seguridad para la restauración.
  • Si un componente se incluye implícitamente en la copia de seguridad y no es seleccionable para la restauración sin que se pueda seleccionar para los antecesores de restauración, lo que en el caso de copia de seguridad implicaría la necesidad de inclusión explícita; el componente no se incluye explícitamente (es decir, no se agrega al documento componentes de copia de seguridad mediante IVssBackupComponents::SetSelectedForRestore). Este componente debe considerarse seleccionado implícitamente para la restauración.
  • De esos componentes seleccionados implícitamente para la copia de seguridad (si ese componente se puede seleccionar para la copia de seguridad o no), solo los que se pueden seleccionar para la restauración se pueden agregar al documento componentes de copia de seguridad mediante IVssBackupComponents::AddRestoreSubcomponent.
  • Puede seleccionar para los componentes de restauración definir un conjunto de componentes para la restauración, igual que se puede seleccionar para los componentes de copia de seguridad. Este componente seleccionable para restaurar y, a continuación, define este conjunto de componentes para la operación de restauración.

Un escritor sin componentes seleccionados explícitamente para la restauración antes de la generación de un evento PreRestore no recibirá ningún evento vsS.

Los solicitantes y escritores pueden acceder a la información de los componentes almacenados mediante la interfaz IVssComponent . A través de la interfaz IVssComponent , los escritores pueden modificar algunas de las opciones de configuración de los componentes incluidos explícitamente en el documento Componentes de copia de seguridad para admitir una restauración (como el destino de restauración). Si define un conjunto de componentes, las modificaciones del escritor de un componente incluido explícitamente se propagarán a sus subcomponentes. Además, la interfaz proporciona un mecanismo para pasar información sobre la restauración correcta y el error entre el escritor y el solicitante.

Como durante la copia de seguridad, no hay suficiente información en el propio documento de componentes de copia de seguridad para implementar la restauración. De nuevo, se requerirá que los documentos de metadatos de escritor proporcionen información sobre las rutas de acceso reales de los archivos que se van a restaurar y para detectar qué componentes no seleccionables forman parte del conjunto de componentes seleccionables y, por tanto, deben restaurarse.

Consulte Working with Selectability and Logical Paths (Trabajar con la capacidad de selección y las rutas lógicas ) para obtener información sobre los tipos de selectibilidad y su uso.

Uso de la información del documento del componente escritor por parte del solicitante

Cada componente se identifica de forma única mediante el identificador de clase writer de su escritor primario, su nombre y su ruta de acceso lógica.

El solicitante puede usar la interfaz IVssWriterComponentsExt devuelta por el método IVssBackupComponents::GetWriterComponents para obtener información sobre cada componente almacenado.

El nombre del componente y la ruta de acceso lógica (entre otros elementos) se pueden encontrar a través de la interfaz IVssComponent devuelta por IVssWriterComponentsExt::GetComponent.

Nota

Durante la fase de restauración, el solicitante debe llamar a IVssWriterComponentsExt::GetComponent o IVssWriterComponentsExt::GetComponentCount solo después de la llamada a IVssBackupComponents::P reRestore , para permitir que el escritor actualice el documento de componentes de copia de seguridad. Un ejemplo de esta actualización sería cambiar el destino de restauración.

 

Puede encontrar información sobre el escritor primario de cada componente seleccionable almacenado mediante IVssWriterComponentsExt::GetWriterInfo.

Con esta información, se pueden consultar los documentos de metadatos del escritor y el documento coincidente identificado. A continuación, mediante la ruta de acceso lógica, el solicitante puede identificar los componentes no seleccionables dependientes para cada componente seleccionable, es decir, identificar todos los miembros del conjunto de componentes seleccionables.

Con la interfaz IVssExamineWriterMetadata , el solicitante ahora tiene información completa del componente (incluida la especificación de ruta de acceso (de la interfaz IVssWMComponent ) para los componentes seleccionables y no seleccionables que necesita para realizar copias de seguridad o restaurar.

Este es un motivo por el que es fundamental que un solicitante guarde tanto el estado de su propio documento de componentes de copia de seguridad como los documentos de metadatos de escritor de los escritores de los que realiza la copia de seguridad.

Consulte Working with Selectability and Logical Paths (Trabajar con la capacidad de selección y las rutas lógicas ) para obtener información más detallada.