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

  • Artículo

El método DeleteSnapshots elimina una o varias instantáneas o un conjunto de instantáneas.

Sintaxis

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

Parámetros

[in] SourceObjectId

Identificador de la instantánea o de un conjunto de instantáneas que se va a eliminar.

[in] eSourceObjectType

Tipo del objeto en el que se eliminarán todas las instantáneas. El valor de este parámetro es VSS_OBJECT_SNAPSHOT o VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

Si el valor de este parámetro es TRUE, el proveedor hará todo lo posible para eliminar la instantánea o las instantáneas en un conjunto de instantáneas. Si es FALSE, no se realizará ningún esfuerzo adicional.

[out] plDeletedSnapshots

Número de instantáneas eliminadas.

[out] pNondeletedSnapshotID

Si se produce un error, el valor de este parámetro es el identificador de la primera instantánea que no se pudo eliminar. De lo contrario, es GUID_NULL.

Valor devuelto

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

Valor Significado
S_OK
 Las instantáneas se eliminaron correctamente.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
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, 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.
VSS_E_OBJECT_NOT_FOUND
 La instantánea especificada no existe.
VSS_E_PROVIDER_VETO
 Error de proveedor esperado. El proveedor registró el error en el registro de eventos. Para obtener más información, vea Control de eventos y errores en VSS.
VSS_E_UNEXPECTED_PROVIDER_ERROR
 Error inesperado del proveedor. El código de error se registra en el registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Comentarios

Varias instantáneas de un conjunto de instantáneas se eliminan secuencialmente. Si se produce un error durante una de estas eliminaciones individuales, DeleteSnapshots devolverá inmediatamente; no se intentará eliminar las instantáneas restantes. El VSS_ID de la instantánea sin eliminar se devuelve en pNondeletedSnapshotID.

El solicitante es responsable de serializar la operación de eliminación de instantáneas.

Durante una copia de seguridad, las instantáneas se liberan automáticamente en cuanto se libera la instancia de IVssBackupComponents . En este caso, no es necesario eliminar explícitamente las 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

IVssBackupComponents

IVssBackupComponents::StartSnapshotSet

VSS_ID