Clase IVssComponent (vswriter.h)
La interfaz IVssComponent es una interfaz de C++ (no COM) que contiene métodos para examinar y modificar información sobre los componentes contenidos en el documento de componentes de copia de seguridad de un solicitante.
Los objetos IVssComponent solo se pueden obtener para los componentes que se han agregado explícitamente al documento de componentes de copia de seguridad durante una operación de copia de seguridad mediante el método IVssBackupComponents::AddComponent.
La información sobre los componentes agregados explícitamente durante una operación de restauración mediante IVssBackupComponents::AddRestoreSubcomponent no está disponible a través de la interfaz IVssComponent .
Parte de la información común a los componentes y a los subcomponentes seleccionados implícitamente disponibles a través de objetos IVssComponent incluye lo siguiente:
- Marca de tiempo de copia de seguridad
- Mensajes de error anteriores o posteriores a la restauración
- Restauración de metadatos
- Destino de restauración
- Asignaciones de ubicación alternativas
- Archivos parciales
- Destino dirigido
La interfaz puede ser utilizada por un escritor o un solicitante, aunque ciertos métodos solo se admiten para escritores. De este modo, un escritor puede solicitar cambios en una operación de copia de seguridad o restauración, como agregar un nuevo destino o aprender de las acciones del solicitante, como el uso de una ubicación alternativa.
Los métodos siguientes devuelven una interfaz IVssComponent :
Herencia
La interfaz IVssComponent hereda de la interfaz IUnknown . IVssComponent también tiene estos tipos de miembros:
Métodos
La clase IVssComponent tiene estos métodos.
| IVssComponent::AddDifferencedFilesByLastModifyLSN No compatible. (IVssComponent.AddDifferencedFilesByLastModifyLSN) |
| IVssComponent::AddDifferencedFilesByLastModifyTime Usado por un escritor para indicar que un conjunto de archivos (un archivo o archivos especificados) se debe evaluar con una marca de tiempo de última modificación para su inclusión en una copia de seguridad incremental o diferencial con marca de tiempo mediante archivos completos. |
| IVssComponent::AddDirectedTarget El método AddDirectedTarget permite a un escritor indicar en el momento de la restauración que, cuando se va a restaurar un archivo, se debe reasignar (el archivo de origen). |
| IVssComponent::AddPartialFile El método AddPartialFile indica que solo se va a realizar una copia de seguridad de partes de un archivo determinado y cuáles son las partes. |
| IVssComponent::GetAdditionalRestores Un escritor usa el método GetAdditionalRestores durante las operaciones de restauración incremental o diferencial para determinar si un componente determinado requerirá operaciones de restauración adicionales para recuperarla por completo. |
| IVssComponent::GetAlternateLocationMapping GetAlternateLocationMapping se usa para devolver la ubicación alternativa de un conjunto de archivos para la restauración de archivos. Un escritor o un solicitante pueden llamar a este método. |
| IVssComponent::GetAlternateLocationMappingCount El método GetAlternateLocationMappingCount devuelve el número de asignaciones de ubicación alternativas usadas por un solicitante en la restauración de datos. Un escritor o un solicitante pueden llamar a este método. |
| IVssComponent::GetBackupMetadata El método GetBackupMetadata recupera metadatos de copia de seguridad privados específicos del escritor que podrían haberse establecido durante un evento PrepareForBackup por parte de CVssWriter::OnPrepareBackup mediante IVssComponent::SetBackupMetadata. |
| IVssComponent::GetBackupOptions El método GetBackupOptions devuelve las opciones de copia de seguridad especificadas en el escritor que administra el componente o componente seleccionado actualmente establecido por un solicitante mediante IVssBackupComponents::SetBackupOptions. |
| IVssComponent::GetBackupStamp El método GetBackupStamp devuelve la cadena de marca de copia de seguridad almacenada por un escritor para un componente determinado. |
| IVssComponent::GetBackupSucceeded El método GetBackupSucceeded devuelve el estado de un intento completo de realizar una copia de seguridad de todos los archivos de un componente o componente seleccionado establecido como una enumeración VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetComponentName El método GetComponentName devuelve el nombre lógico de este componente. |
| IVssComponent::GetComponentType El método GetComponentType devuelve el tipo de este componente en términos de la enumeración VSS_COMPONENT_TYPE. |
| IVssComponent::GetDifferencedFile El método GetDifferencedFile devuelve información sobre un conjunto de archivos (un archivo o archivos especificados) para participar en una copia de seguridad o restauración incremental o diferencial como un archivo diferente, es decir, las copias de seguridad y restauraciones asociadas a él se implementarán como si se copiaran archivos completos en y desde medios de copia de seguridad (en lugar de usar archivos parciales). |
| IVssComponent::GetDifferencedFilesCount Devuelve el número de especificaciones de archivo de este componente (y en los subcomponentes del conjunto de componentes que define) marcados por un escritor que admite una copia de seguridad incremental o restauración como archivos diferentes. |
| IVssComponent::GetDirectedTarget El método GetDirectedTarget devuelve información almacenada por un escritor, en tiempo de copia de seguridad, en el documento componentes de copia de seguridad para indicar que, cuando se va a restaurar un archivo, se debe reasignar (el archivo de origen). |
| IVssComponent::GetDirectedTargetCount El método GetDirectedTargetCount devuelve el número de especificaciones de destino dirigidas asociadas al componente actual. Un escritor o un solicitante pueden llamar a este método. |
| IVssComponent::GetFileRestoreStatus El método GetFileRestoreStatus devuelve el estado de un intento completado de restaurar todos los archivos de un componente o componente seleccionado establecido como una enumeración VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetLogicalPath El método GetLogicalPath devuelve la ruta de acceso lógica de este componente. |
| IVssComponent::GetNewTarget El método GetNewTarget devuelve las nuevas ubicaciones de restauración de archivos para el componente o conjunto de componentes seleccionado. |
| IVssComponent::GetNewTargetCount El método GetNewTargetCount devuelve el número de nuevas ubicaciones de restauración de destino asociadas a un componente determinado. |
| IVssComponent::GetPartialFile El método GetPartialFile devuelve información sobre un archivo parcial asociado a este componente. |
| IVssComponent::GetPartialFileCount El método GetPartialFileCount devuelve el número de archivos parciales asociados a un componente. |
| IVssComponent::GetPostRestoreFailureMsg El método GetPostRestoreFailureMsg devuelve el mensaje de error generado por un escritor mientras controla el evento PostRestore, si IVssComponent::SetPostRestoreFailureMsg establece uno. |
| IVssComponent::GetPreRestoreFailureMsg El método GetPreRestoreFailureMsg recupera el mensaje de error generado por un escritor mientras controla el evento PreRestore, si IVssComponent::SetPreRestoreFailureMsg establece uno. |
| IVssComponent::GetPreviousBackupStamp El método GetPreviousBackupStamp devuelve una marca de copia de seguridad anterior cargada por un solicitante en el documento componentes de copia de seguridad. El escritor usa el valor al decidir si los archivos deben participar en la operación diferencial o incremental de copia de seguridad. |
| IVssComponent::GetRestoreMetadata El método GetRestoreMetadata recupera metadatos de restauración privados específicos del escritor que podrían haberse establecido durante un evento PreRestore por parte de CVssWriter::OnPreRestore mediante IVssComponent::SetRestoreMetadata. |
| IVssComponent::GetRestoreOptions El método GetRestoreOptions obtiene las opciones de restauración especificadas para el escritor actual mediante un solicitante mediante IVssBackupComponents::SetRestoreOptions. |
| IVssComponent::GetRestoreSubcomponent El método GetRestoreSubcomponent devuelve el subcomponente especificado asociado a un componente determinado. |
| IVssComponent::GetRestoreSubcomponentCount El método GetRestoreSubcomponentCount devuelve el número de subcomponentes asociados a un componente. |
| IVssComponent::GetRestoreTarget El método GetRestoreTarget devuelve el destino de restauración (en términos de la enumeración VSS_RESTORE_TARGET) para el componente actual. |
| IVssComponent::IsSelectedForRestore El método IsSelectedForRestore determina si el componente actual se ha seleccionado para restaurarse. |
| IVssComponent::SetBackupMetadata El método SetBackupMetadata establece los metadatos de copia de seguridad con el componente . |
| IVssComponent::SetBackupStamp El método SetBackupStamp establece una cadena que contiene información que indica cuándo se realizó una copia de seguridad. |
| IVssComponent::SetPostRestoreFailureMsg El método SetPostRestoreFailureMsg se usa para crear un mensaje que describa un error al procesar un evento PostRestore. |
| IVssComponent::SetPreRestoreFailureMsg El método SetPreRestoreFailureMsg se usa para crear un mensaje que describa un error al procesar un evento PreRestore. |
| IVssComponent::SetRestoreMetadata El método SetRestoreMetadata establece metadatos específicos del escritor para el componente actual. |
| IVssComponent::SetRestoreTarget El método SetRestoreTarget establece el destino de restauración (en términos de la enumeración VSS_RESTORE_TARGET) para el componente actual. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vswriter.h (incluya Vss.h, VsWriter.h) |