Compartir a través de

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

  • Artículo

Elimina instantáneas específicas o todas las instantáneas de un conjunto de instantáneas especificado.

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 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, consulte Control de eventos y errores en VSS.

Comentarios

El coordinador de VSS llama a este método como parte del proceso de liberación automática de instantáneas. También se llama al método en respuesta a las operaciones de eliminación controladas por el solicitante.

Requisitos

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

Consulte también

IVssFileShareSnapshotProvider