Compartir a través de

Método IVssDifferentialSoftwareSnapshotMgmt3::D eleteUnusedDiffAreas (vsmgmt.h)

  • Artículo

Elimina todas las áreas de almacenamiento de instantáneas (también denominadas áreas de diferencias) en el volumen especificado que no está en uso.

Sintaxis

HRESULT DeleteUnusedDiffAreas(
  [in] VSS_PWSZ pwszDiffAreaVolumeName
);

Parámetros

[in] pwszDiffAreaVolumeName

El nombre del objeto visual. Este parámetro es obligatorio y no puede ser NULL.

El nombre debe tener uno de los siguientes formatos y debe incluir una barra diagonal inversa final (\):

  • Ruta de acceso de una carpeta montada, por ejemplo, Y:\MountX\
  • Una letra de unidad, por ejemplo, D:\
  • Ruta de acceso del GUID de volumen con el formato \\?\Volume{GUID}\ (donde GUID identifica el volumen)

Valor devuelto

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

Valor Significado
S_OK
 Las áreas de almacenamiento de instantáneas se eliminaron correctamente.
E_ACCESSDENIED
0x80070005L
 El autor de la llamada no es administrador.
E_INVALIDARG
0x80070057L
 Uno de los valores de parámetro no es válido.
E_NOTIMPL
0x800000001L
 El proveedor del volumen no admite la protección contra instantáneas.
VSS_E_PROVIDER_VETO
0x80042306L
 Se ha producido un error de proveedor esperado. El código de error se registra en el registro de eventos. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 No se encontró el volumen especificado.

Comentarios

Los archivos de área de almacenamiento de instantáneas sin usar se encuentran en volúmenes de área de almacenamiento cuando el volumen original asociado está sin conexión debido a un error de protección. En ciertos casos, el volumen original puede perderse permanentemente y llamar al método DeleteUnusedDiffAreas es la única manera de recuperar el espacio de área de almacenamiento abandonado.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsmgmt.h

Consulte también

IVssDifferentialSoftwareSnapshotMgmt3