Compartir a través de

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

  • Artículo

Determina si el proveedor admite instantáneas en el volumen especificado.

Sintaxis

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

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

[out] pbSupportedByThisProvider

Este parámetro recibe TRUE si se admiten instantáneas en el volumen especificado; de lo contrario, FALSE.

Valor devuelto

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

Value 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 administrador.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
VSS_E_NESTED_VOLUME_LIMIT
 El volumen especificado está anidado 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.
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, consulte 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, 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.

Comentarios

El método IsVolumeSupported devolverá TRUE si es posible crear instantáneas en el volumen especificado, aunque la configuración actual no permita la creación de instantáneas en ese volumen en el momento actual.

Por ejemplo, si se ha alcanzado el número máximo de instantáneas en un volumen determinado (y, por lo tanto, no se pueden crear más instantáneas en ese volumen), el método seguirá indicando que el volumen se puede copiar en sombras.

No se puede llamar a este método para un disco duro virtual (VHD) anidado dentro de otro VHD.

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

Requisitos

   
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