Método IVssBackupComponents::IsVolumeSupported (vsbackup.h)

El método IsVolumeSupported determina si el proveedor especificado admite instantáneas en el volumen o recurso compartido de archivos remoto especificado.

Sintaxis

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

Parámetros

[in] ProviderId

Identificador del proveedor. Si el valor es GUID_NULL, IsVolumeSupported comprueba si cualquier proveedor admite el volumen o el recurso compartido de archivos remoto.

[in] pwszVolumeName

Nombre del volumen o ruta de acceso UNC del recurso compartido de archivos remoto. El nombre o la ruta de acceso UNC deben estar en uno de los siguientes formatos y deben 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)
• Ruta de acceso UNC que especifica un recurso compartido de archivos remoto, por ejemplo, \\Clusterx\Share1\

[out] pbSupportedByThisProvider

Dirección de una variable asignada por el autor de la llamada que recibe TRUE si se admiten instantáneas en el volumen o recurso compartido de archivos remoto especificado, o FALSE en caso contrario.

Valor devuelto

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

Valor	Significado
S_OK	Devolvió correctamente la información de soporte técnico del proveedor.
E_ACCESSDENIED	El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
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_BAD_STATE	El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta.
VSS_E_OBJECT_NOT_FOUND	No se encontró el volumen especificado o el recurso compartido de archivos remotos o no estaba disponible.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: Los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012.

IsVolumeSupported devolverá TRUE si es posible crear instantáneas en el volumen especificado, incluso si la configuración actual no permite 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.

Nota Para obtener más información sobre el número máximo de instantáneas que se pueden crear en un volumen, vea la entrada de MaxShadowCopies en Claves y valores del Registro para copia de seguridad y restauración.

 

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

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

Consulte también

IVssBackupComponents

IVssBackupComponents::AddToSnapshotSet