Compartir a través de

Función IsVolumeSnapshotted (vsbackup.h)

  • Artículo

La función IsVolumeSnapshotted determina si existen instantáneas para el volumen especificado.

Nota Esta función se exporta como IsVolumeSnapshottedInternal, pero debe llamar a IsVolumeSnapshotted, no IsVolumeSnapshottedInternal.
 

Sintaxis

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCapability
);

Parámetros

[in] pwszVolumeName

Nombre del volumen. El nombre del volumen que se va a comprobar 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 del formulario \\?\Volume{GUID}\ (donde GUID identifica el volumen)

[out] pbSnapshotsPresent

El valor de este parámetro es TRUE si el volumen tiene una instantánea y FALSE si el volumen no tiene una instantánea.

[out] plSnapshotCapability

Máscara de bits (o OR bit a bit) de VSS_SNAPSHOT_COMPATIBILITY valores que indican si determinadas operaciones de control de volumen o de E/S de archivos están deshabilitadas para el volumen determinado si existe una instantánea de él.

Valor devuelto

Los valores devueltos que se enumeran aquí están además de los VALORES HRESULT COM normalesque se pueden devolver en cualquier momento desde la función.

Valor Significado
S_OK
 Si se devuelve este valor, significa que la función se completó correctamente.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
E_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 Memoria insuficiente u otros recursos del sistema.
VSS_E_PROVIDER_VETO
 Se esperaba un error de proveedor. El proveedor registró el error en el registro de eventos. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND
 No se encontró el volumen especificado.
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_UNEXPECTED_PROVIDER_ERROR
 Error inesperado del proveedor. El código de error se registra en el archivo de registro de eventos. Para obtener más información, consulte Control de eventos y errores en VSS.

Comentarios

Antes de llamar a esta función, el autor de la llamada debe haber inicializado COM llamando a la función CoInitialize .

Si no se deshabilita ningún control de volumen o operaciones de E/S de archivos para el volumen seleccionado, la funcionalidad de instantáneas del volumen seleccionado devuelto por plSnapshotCapability será cero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib
Archivo DLL VssApi.dll

Consulte también

VSS_SNAPSHOT_COMPATIBILITY