Compartir a través de

Método IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel (vsmgmt.h)

  • Artículo

Establece el nivel de protección de instantáneas para un volumen original o un volumen de área de almacenamiento de instantáneas.

Sintaxis

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL protectionLevel
);

Parámetros

[in] pwszVolumeName

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 GUID de volumen con el formato \\?\Volume{GUID}\ (donde GUID identifica el volumen)

[in] protectionLevel

Valor de la enumeración VSS_PROTECTION_LEVEL que especifica el nivel de protección de instantáneas.

Valor devuelto

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

Valor Significado
S_OK
 El nivel de protección de instantáneas se estableció correctamente.
E_ACCESSDENIED
0x80070005L
 El autor de la llamada no es un 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, vea Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 No se encontró el volumen especificado.

Comentarios

El método SetVolumeProtectLevel comprueba el nivel de protección de instantáneas actual del volumen. Si el volumen está en un estado defectuoso y VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME se especifica para el parámetro protectionLevel , SetVolumeProtectLevel desmonta el volumen antes de establecer el nivel de protección.

Si el nivel de protección actual del volumen es el mismo que el valor del parámetro protectionLevel , SetVolumeProtectLevel no hace nada.

Si el valor del parámetro protectionLevel es VSS_PROTECTION_LEVEL_SNAPSHOT, los solicitantes deben establecer asociaciones de área de almacenamiento de instantáneas (área de diferencias) mediante el método IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

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

IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel