Compartir a través de

Método IVssBackupComponentsEx2::BreakSnapshotSetEx (vsbackup.h)

  • Artículo

Interrumpe un conjunto de instantáneas según las opciones especificadas por el solicitante.

Sintaxis

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

Parámetros

[in] SnapshotSetID

Identificador del conjunto de instantáneas.

[in] dwBreakFlags

Máscara de bits de marcas de _VSS_HARDWARE_OPTIONS que especifican cómo se interrumpe el conjunto de instantáneas.

[out] ppAsync

Puntero a una variable que recibe un puntero de interfaz IVssAsync que se puede usar para recuperar el estado de la operación de interrupción del conjunto de instantáneas. Una vez completada la operación de interrupción, se debe llamar al método IUnknown::Release para este puntero de interfaz.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Value Significado
S_OK
0x00000000L
 El conjunto de instantáneas se interrumpió correctamente.
E_ACCESSDENIED
0x80070005L
 El autor de la llamada no tiene privilegios suficientes o no es un administrador.
E_INVALIDARG
0x80070057L
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
0x8007000EL
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 Error en la operación de interrupción del conjunto de instantáneas porque la firma del disco MBR, el identificador de disco GPT o el identificador de partición GPT de uno o varios de los LUN de destino no se pudieron revertir a los de los LUN originales. Si uno o varios LUN originales no están enmascarados en el equipo, la operación de interrupción provocaría una colisión de firmas.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 La instantánea especificada no existe.
VSS_E_PROVIDER_VETO
0x80042306L
 El proveedor de software creó la instantánea y no se puede romper.
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.

Comentarios

BreakSnapshotSetEx es similar al método IVssBackupComponents::BreakSnapshotSet , salvo que tiene parámetros adicionales para consultar el estado de la consulta y especificar cómo se interrumpe el conjunto de instantáneas.

Al igual que BreakSnapshotSet, BreakSnapshotSetEx solo se puede usar para instantáneas creadas por un proveedor de instantáneas de hardware.

Una vez devuelto este método, el volumen de instantáneas sigue siendo un volumen, pero ya no es una instantánea. Para obtener más información, vea Instantáneas de interrupción.

Requisitos

   
Cliente mínimo compatible Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)