IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx (vsmgmt.h)

Novedades el tamaño máximo del área de almacenamiento de instantáneas para un volumen determinado. Esto puede no tener un efecto inmediato. Si el parámetro bVolatile es FALSE, el cambio continúa aunque se reinicie el equipo.

Sintaxis

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

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 del formulario \\?\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 con, por ejemplo, D:\
• Ruta de acceso guid de volumen del formulario \\?\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.

[in] bVolatile

TRUE para indicar que el efecto de llamar al método ChangeDiffAreaMaximumSizeEx no debe continuar si se reinicia el equipo; de lo contrario, FALSE.

El valor predeterminado es FALSE.

Si el parámetro llMaximumDiffSpace es cero, el parámetro bVolatile debe ser FALSE.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	Se cambió 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 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	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_UNEXPECTED	error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte 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 ChangeDiffAreaMaximumSizeEx es idéntico al método IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize excepto para el parámetro bVolatile .

Llamar al método ChangeDiffAreaMaximumSizeEx con el parámetro bVolatile establecido en FALSE es el mismo que llamar al método ChangeDiffAreaMaximumSize .

ChangeDiffAreaMaximumSizeEx 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 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vsmgmt.h

Consulte también

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize