Función ShouldBlockRevert (vsbackup.h)

Comprueba el registro para los escritores que deben bloquear las operaciones de reversión en el volumen especificado.

Nota Esta función solo está disponible en sistemas operativos Windows Server.

 

Sintaxis

HRESULT ShouldBlockRevert(
  [in]  LPCWSTR wszVolumeName,
  [out] bool    *pbBlock
);

Parámetros

[in] wszVolumeName

El nombre del objeto visual. Este 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] pbBlock

Puntero a una variable que recibe true si el volumen contiene componentes de cualquier escritor que aparezca en el Registro como escritores que deben bloquear las operaciones de reversión o false de lo contrario.

Valor devuelto

Esta función puede devolver uno de estos valores.

Valor	Significado
S_OK	La función se ha realizado correctamente.
E_ACCESSDENIED	El autor de la llamada 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_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

La lista de escritores que deben bloquear las operaciones de reversión se almacena en el Registro con la siguiente clave:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Settings\WritersBlockingRevert

Requisitos

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008, Windows Server 2003 con SP1 [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