Método IVssBackupComponents::SetBackupSucceededed (vsbackup.h)
El método SetBackupSucceededed indica si la copia de seguridad del componente especificado de un escritor específico se realizó correctamente.
Sintaxis
HRESULT SetBackupSucceeded(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSucceded
);
Parámetros
[in] instanceId
Identificador único global (GUID) de la instancia de escritor.
[in] writerId
Identificador único global (GUID) de la clase writer.
[in] ct
Tipo del componente. Consulte VSS_COMPONENT_TYPE para conocer los valores posibles.
[in] wszLogicalPath
Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente.
Para obtener más información, vea Ruta de acceso lógica de componentes.
El valor de la cadena que contiene la ruta de acceso lógica usada aquí debe ser el mismo que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.
La ruta de acceso lógica 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.
La cadena no puede ser NULL y debe contener el mismo nombre de componente que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.
[in] bSucceded
Establezca este parámetro en true si se ha realizado correctamente una copia de seguridad del componente o false en caso contrario.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Value | Significado |
|---|---|
|
Establezca correctamente el estado correcto de la copia de seguridad. |
|
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 componente de copia de seguridad no existe. |
|
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. |
|
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
Al trabajar en modo de componente (cuando se llama a IVssBackupComponents::SetBackupState con su argumento select components establecido en true), los escritores comprueban el estado de cada copia de seguridad de componentes mediante IVssComponent::GetBackupSucceeded. Por lo tanto, una aplicación de copia de seguridad (solicitante) con buen comportamiento debe llamar a SetBackupSucceeded después de procesar cada componente y antes de llamar a IVssBackupComponents::BackupComplete.
No llame a este método si se produjo un error en la llamada a IVssBackupComponents::D oSnapshotSet . Para obtener más información sobre cómo los solicitantes usan DoSnapshotSet, SetBackupSucceeded yBackupComplete en una operación de copia de seguridad, vea Overview of Pre-Backup Tasks and Overview of Real Backup Of Files.
Requisitos
| 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::BackupComplete