Compartir a través de

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

  • Artículo

El método AddDiffArea agrega una asociación de área de almacenamiento de instantáneas para el volumen especificado. Si no se admite la asociación, se devolverá un código de error.

Sintaxis

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

Parámetros

[in] pwszVolumeName

Nombre del volumen que será 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 contendrá el área de almacenamiento de instantáneas que se va a asociar 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

Tamaño máximo, en bytes, del área de almacenamiento de instantáneas en el volumen. Este valor debe ser de al menos 320 MB, hasta el límite de todo el sistema. Si este valor es –1, el tamaño máximo es ilimitado.

Windows Server 2003: Antes de Windows Server 2003 con SP1, el tamaño del área de almacenamiento de instantáneas se corrigió a 100 MB.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
 Se agregó correctamente la asociación 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_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 El número máximo de áreas de almacenamiento de instantáneas se ha agregado al volumen de origen de instantáneas. El volumen de almacenamiento de instantáneas especificado no estaba asociado al volumen de origen de instantáneas especificado.
VSS_E_NESTED_VOLUME_LIMIT
 El volumen especificado se anida demasiado para participar en la operación de VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admite este código de retorno.
VSS_E_OBJECT_ALREADY_EXISTS
 La asociación entre los volúmenes pwszVolumeName y pwszDiffAreaVolumeName ya existe.
VSS_E_PROVIDER_VETO
 Error de proveedor esperado. 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_NOT_SUPPORTED
 El volumen pwszDiffAreaVolumeName no es un volumen NTFS o no tiene suficiente espacio disponible.

Comentarios

No se puede crear una asociación de área de almacenamiento de instantáneas si ya existen instantáneas para el volumen pwszVolumeName o si ya hay una asociación de área de almacenamiento de instantáneas para ese volumen.

El área de almacenamiento de instantáneas para un volumen de origen de disco duro virtual (VHD) debe residir en el mismo volumen. Del mismo modo, un área de almacenamiento de instantáneas solo se puede crear en un volumen VHD si el volumen de origen es el mismo para ambos volúmenes.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admiten discos duros virtuales.

Para cambiar el tamaño de un área de almacenamiento de instantáneas, use el método IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize o IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx . Puede eliminar un área de almacenamiento de instantáneas cambiando su tamaño a cero.

Requisitos

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

Consulte también

IVssDifferentialSoftwareSnapshotMgmt