Método IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Confirma todas las instantáneas de este conjunto simultáneamente.

Sintaxis

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

Parámetros

[out] ppAsync

Puntero indirecto doble a la interfaz asincrónica IVssAsync necesaria. Se usa para consultar el estado de ejecución del método y recuperar el código de error final.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método. Estos códigos de error se pueden devolver desde este método o desde el método QueryStatus en la interfaz IVssAsync devuelta en el parámetro ppAsync .

Valor Significado
S_OK
Devolvió correctamente un puntero a una instancia de la interfaz IVssAsync . Consulte IVssAsync::QueryStatus para conocer los valores válidos devueltos por el parámetro pHrResult .
E_ACCESSDENIED
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
E_INVALIDARG
ppAsync no apunta a un puntero válido; es decir, es NULL.
E_OUTOFMEMORY
El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_BAD_STATE
El objeto de componentes de copia de seguridad no se ha inicializado o las llamadas de requisitos previos para un contexto de instantánea determinado no se han realizado antes de llamar a DoSnapshotSet.
VSS_E_INSUFFICIENT_STORAGE
El sistema o proveedor no tiene suficiente espacio de almacenamiento. Si es posible, elimine las instantáneas persistentes antiguas o innecesarias e inténtelo de nuevo. Este código de error solo se devuelve a través del método QueryStatus en la interfaz IVssAsync devuelta en el parámetro ppAsync .
VSS_E_FLUSH_WRITES_TIMEOUT
El sistema no pudo vaciar las escrituras de E/S. Esto puede ser un problema transitorio. Se recomienda esperar diez minutos e intentarlo de nuevo, hasta tres veces.
VSS_E_HOLD_WRITES_TIMEOUT
El sistema no pudo contener escrituras de E/S. Esto puede ser un problema transitorio. Se recomienda esperar diez minutos e intentarlo de nuevo, hasta tres veces.
VSS_E_NESTED_VOLUME_LIMIT
El volumen especificado está anidado demasiado para participar en la operación de VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admite este código de retorno.

VSS_E_PROVIDER_VETO
El proveedor no pudo realizar la solicitud en este momento. Esto puede ser un problema transitorio. Se recomienda esperar diez minutos e intentarlo de nuevo, hasta tres veces. Este código de error solo se devuelve a través del método QueryStatus en la interfaz IVssAsync devuelta en el parámetro ppAsync .
VSS_E_REBOOT_REQUIRED
El proveedor encontró un error que requiere que el usuario reinicie el equipo.

Windows Server 2003 y Windows XP: Este valor no se admite.

VSS_E_TRANSACTION_FREEZE_TIMEOUT
El sistema no pudo inmovilizar el Coordinador de transacciones distribuidas (DTC) o el Administrador de transacciones de kernel (KTM).

Windows Server 2003 y Windows XP: Este valor no se admite.

VSS_E_TRANSACTION_THAW_TIMEOUT
El sistema no pudo descongelar el Coordinador de transacciones distribuidas (DTC) o el Administrador de transacciones de kernel (KTM).

Windows Server 2003 y Windows XP: Este valor no se admite.

VSS_E_UNEXPECTED
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.

VSS_E_UNEXPECTED_PROVIDER_ERROR
El proveedor devolvió un código de error inesperado. Esto puede ser un problema transitorio. Se recomienda esperar diez minutos e intentarlo de nuevo, hasta tres veces. Este código de error solo se devuelve a través del método QueryStatus en la interfaz IVssAsync devuelta en el parámetro ppAsync .

Comentarios

El autor de la llamada es responsable de liberar la interfaz IVssAsync .

No se puede llamar a este método para un disco duro virtual (VHD) anidado dentro de otro VHD.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admiten discos duros virtuales.

Para obtener información sobre cómo usar IVssBackupComponents::D oSnapshotSet para crear una instantánea de copia de seguridad estándar, vea Información general sobre las tareas previas a la copia de seguridad y creación de instantáneas simples para copia de seguridad. Para obtener información sobre cómo se usa el método en diferentes contextos de VSS, vea Detalles de implementación para crear instantáneas.

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

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet