Método IVssBackupComponents::AddComponent (vsbackup.h)
El método AddComponent se usa para agregar explícitamente al conjunto de copia de seguridad en el documento componentes de copia de seguridad todos los componentes necesarios (no seleccionables para los componentes de copia de seguridad sin que se pueda seleccionar para el antecesor de copia de seguridad) y componentes opcionales (seleccionables para copia de seguridad) a medida que el solicitante considera necesario. Los miembros de los conjuntos de componentes (componentes con un elemento seleccionable para el antecesor de copia de seguridad) se incluyen implícitamente en el conjunto de copia de seguridad, pero no se agregan explícitamente al documento componentes de copia de seguridad.
Sintaxis
HRESULT AddComponent(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName
);
Parámetros
[in] instanceId
Identifica una instancia específica de un escritor.
[in] writerId
Identificador de clase de escritor.
[in] ct
Identifica el tipo del componente. Consulte la documentación de VSS_COMPONENT_TYPE para conocer los valores de entrada permitidos.
[in] wszLogicalPath
Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente de copia de seguridad seleccionable. Para obtener más información, consulte Ruta de acceso lógica de componentes.
No se requiere una ruta de acceso lógica al agregar un componente. Por lo tanto, el valor de este parámetro 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 de copia de seguridad seleccionable.
El valor de este parámetro no puede ser NULL.
No hay restricciones en los caracteres que pueden aparecer en una ruta lógica que no sea NULL .
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se agregó correctamente el componente. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS. |
|
El objeto es un duplicado. Ya existe un componente con la misma ruta de acceso lógica y nombre de componente. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte 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
El método AddComponent solo tiene significado si la operación de copia de seguridad tiene lugar en modo de componente.
Solo estos tipos de componentes se deben agregar al documento componentes de copia de seguridad mediante AddComponent.
- Componentes que se pueden seleccionar para la copia de seguridad (consulte la capacidad de selección de copia de seguridad).
- Componentes no seleccionables para copia de seguridad sin antecesores seleccionables para copia de seguridad.
Los componentes no seleccionables para los componentes de copia de seguridad que tienen un elemento seleccionable para el antecesor de copia de seguridad en la jerarquía de sus rutas lógicas forman parte de un conjunto de componentes definido por el que se puede seleccionar para el antecesor de copia de seguridad. Estos componentes se agregan implícitamente al documento componentes de copia de seguridad cuando se agrega el antecesor y nunca se deben agregar explícitamente al documento de componentes de copia de seguridad de un solicitante mediante AddComponent. El resultado de hacerlo no está definido (consulte Trabajar con la capacidad de selección y las rutas de acceso lógicas).
Los componentes de copia de seguridad con seleccionables para los antecesores de copia de seguridad también son subcomponentes en un conjunto de componentes. Se pueden seleccionar implícitamente si se selecciona su antecesor (en cuyo caso no se agregan al documento componentes de copia de seguridad mediante AddComponent), o bien se pueden seleccionar explícitamente mediante AddComponent.
La combinación de ruta de acceso lógica y nombre para cada componente de una instancia determinada de una clase determinada de escritor debe ser única. Al intentar llamar a AddComponent dos veces con los mismos valores de wszLogicalPath y wszComponentName , se produce un error de VSS_E_OBJECT_ALREADY_EXISTS.
La distinción entre instanceId y writerID es necesaria porque es posible ejecutar varias copias para el mismo escritor.
Se puede encontrar el identificador de clase y la instancia de un escritor llamando a IVssExamineWriterMetadata::GetIdentity.
Antes de llamar a AddComponent, un solicitante debe haberse inicializado para la copia de seguridad llamando a IVssBackupComponents::InitializeForBackup e IVssBackupComponents::GatherWriterMetadata. Consulte Información general sobre la inicialización de copia de seguridad.
El solicitante debe llamar a AddComponent para agregar los componentes necesarios a la instantánea antes de llamar a IVssBackupComponents::D oSnapshotSet para crear la instantánea. Consulte Información general sobre la fase de detección de copias de seguridad e información general sobre las tareas previas a la copia de seguridad.
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 | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |
Consulte también
IVssBackupComponents::P repareForBackup