Compartir a través de

Método IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize (vsmgmt.h)

  • Artículo

El método ChangeDiffAreaMaximumSize actualiza el tamaño máximo del área de almacenamiento de instantáneas para un volumen determinado. Esto puede no tener un efecto inmediato.

Sintaxis

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Parámetros

[in] pwszVolumeName

Nombre del volumen que es el origen de las instantáneas. Este volumen está asociado a un área de almacenamiento de instantáneas en el volumen pwszDiffAreaVolumeName .

El nombre del volumen debe estar en 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 GUID de volumen con el formato \\?\Volume{GUID}\ (donde GUID identifica el volumen)

[in] pwszDiffAreaVolumeName

Nombre del volumen que contiene el área de almacenamiento de instantáneas asociada al volumen pwszVolumeName .

El nombre del volumen debe estar en uno de los siguientes formatos y debe incluir una barra diagonal inversa final (\):

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

[in] llMaximumDiffSpace

Especifica el tamaño máximo, en bytes, del área de almacenamiento de instantáneas que se va a usar para el volumen. Si este valor es cero, se eliminará el área de almacenamiento de instantáneas. Si este valor es –1, el tamaño máximo es ilimitado.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
 Se ha cambiado correctamente el tamaño máximo del área de almacenamiento de instantáneas.
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_INSUFFICIENT_STORAGE
 El volumen pwszDiffAreaVolumeName no tiene suficiente espacio libre.
VSS_E_OBJECT_NOT_FOUND
 No se encontró la asociación entre los volúmenes pwszVolumeName y pwszDiffAreaVolumeName .
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.
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_VOLUME_IN_USE
 Actualmente, una instantánea usa el área de almacenamiento de instantáneas.

Comentarios

El método ChangeDiffAreaMaximumSize hace que el área de almacenamiento de instantáneas sea explícita, lo que significa que no se elimina automáticamente cuando se eliminan todas las instantáneas.

Si el área de almacenamiento de instantáneas no existe, este método lo crea.

Windows Server 2008, Windows Vista y Windows Server 2003: Si el área de almacenamiento de instantáneas no existe, este método no lo crea.

Para crear un área de almacenamiento de instantáneas, use el método IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

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 vsmgmt.h

Consulte también

IVssDifferentialSoftwareSnapshotMgmt