Compartir a través de

Método IVssSoftwareSnapshotProvider::IsVolumeSnapshotted (vsprov.h)

  • Artículo

Determina si existen instantáneas para el volumen especificado.

Sintaxis

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

Parámetros

[in] pwszVolumeName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen. 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] pbSnapshotsPresent

Este parámetro recibe TRUE si el volumen tiene una instantánea o FALSE si el volumen no tiene una instantánea.

[out] plSnapshotCompatibility

Máscara de bits de VSS_SNAPSHOT_COMPATIBILITY valores que indican si determinadas operaciones de E/S de archivos o control de volumen están deshabilitadas para el volumen determinado, si el volumen tiene una instantánea.

Valor devuelto

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

Valor Significado
S_OK
 La información solicitada se devolvió correctamente.
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_OBJECT_NOT_FOUND
 No se encontró el volumen especificado.
VSS_E_PROVIDER_VETO
 Error del proveedor. 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.

Comentarios

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 Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h
Library VssApi.lib

Consulte también

IVssSoftwareSnapshotProvider