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

Artículo
03/08/2023

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