Compartir a través de

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

  • Artículo

Obtiene el nivel de protección de instantáneas y el estado del volumen especificado.

Sintaxis

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *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)

[out] protectionLevel

Dirección de un búfer asignado por el autor de la llamada que recibe una estructura de VSS_VOLUME_PROTECTION_INFO que contiene información sobre el nivel de protección de instantáneas del volumen.

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 ha consultado 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 GetVolumeProtectLevel obtiene información sobre el nivel de protección actual del volumen. Si el volumen está en un estado con errores, el miembro m_protectionFault de la estructura de VSS_VOLUME_PROTECTION_INFO contiene el error de protección actual y el miembro m_failureStatus contiene el motivo por el que el volumen está en estado de error. Si el volumen no está en un estado defectuoso, el m_protectionFault y los miembros m_failureStatus serán cero.

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::SetVolumeProtectLevel