Compartir a través de

Método IVssSoftwareSnapshotProvider::D eleteSnapshots (vsprov.h)

  • Artículo

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 del conjunto de instantáneas que se va a eliminar.

[in] eSourceObjectType

Tipo del objeto que se va a eliminar. 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

Puntero a una variable que recibe el número de instantáneas eliminadas.

[out] pNondeletedSnapshotID

Si se produce un error, este parámetro recibe un puntero al identificador de la primera instantánea que no se pudo eliminar. De lo contrario, apunta a 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_OBJECT_NOT_FOUND
 No se encontraron las instantáneas especificadas.
VSS_E_PROVIDER_VETO
 Error del proveedor. El proveedor registró el error en el registro de eventos. 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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h
Library VssApi.lib

Consulte también

IVssSoftwareSnapshotProvider