Método IVssBackupComponents::AddRestoreSubcomponent (vsbackup.h)
El método AddRestoreSubcomponent indica que un miembro subcomponente de un conjunto de componentes, que se había marcado como no seleccionable para la copia de seguridad, pero que está marcado como seleccionable para restaurarse, se restaurará independientemente de si se restaurará cualquier otro miembro del conjunto de componentes.
Sintaxis
HRESULT AddRestoreSubcomponent(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE componentType,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszSubComponentLogicalPath,
[in] LPCWSTR wszSubComponentName,
[in] bool bRepair
);
Parámetros
[in] writerId
Identificador de clase de escritor.
[in] componentType
Identifica el tipo del componente. Consulte la documentación de VSS_COMPONENT_TYPE para conocer los posibles valores devueltos.
[in] wszLogicalPath
Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente en el documento de copia de seguridad que define el conjunto de componentes de copia de seguridad que contiene el subcomponente que se va a agregar para la restauración.
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 la ruta de acceso lógica del componente en el documento de copia de seguridad que define el conjunto de componentes de copia de seguridad que contiene el subcomponente que se va a agregar para la restauración.
El valor de este parámetro no puede ser NULL.
No hay restricciones en los caracteres que pueden aparecer en un nombre de componente que no sea NULL .
[in] wszSubComponentLogicalPath
Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del subcomponente que se va a agregar para la restauración.
Se requiere una ruta de acceso lógica al agregar un subcomponente. Por lo tanto, 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 .
[in] wszSubComponentName
Cadena de caracteres anchos terminada en NULL que contiene el nombre lógico del subcomponente que se va a agregar para la restauración.
El valor de este parámetro no puede ser NULL.
No hay restricciones en los caracteres que pueden aparecer en un nombre de componente que no sea NULL .
[in] bRepair
Este parámetro se reserva para uso futuro. Este parámetro siempre debe establecerse en false.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se agregó correctamente el subcomponente de restauración. |
|
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, no 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, vea Control de eventos y errores en VSS. |
|
El componente no existe. |
|
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
Antes de llamar a AddRestoreSubcomponent, primero se debe seleccionar el componente raíz definido por los parámetros wszLogicalPath y wszComponentName para la restauración mediante IVssBackupComponents::SetSelectedForRestore.
Si un solicitante es admitir la restauración de subcomponentes, se debe llamar a este método antes de IVssBackupComponents::P reRestore.
AddRestoreSubcomponent está pensado para el caso en el que todos los archivos del conjunto de componentes de un escritor deben realizarse como una unidad, pero donde es conveniente que los archivos seleccionados (subcomponentes) puedan restaurarse individualmente.
Para participar en esta restauración, un subcomponente debe tener el miembro bSelectableForRestore de VSS_COMPONENTINFO establecido en TRUE. El componente definido por los parámetros wszLogicalPath y wszComponentName también debe seleccionarse para la restauración mediante IVssBackupComponents::SetSelectedForRestore.
Para obtener más información, consulte Trabajar con selectibilidad para restaurar y subcomponentes .
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 |