通过

ShouldBlockRevert 函数 (vsbackup.h)

  • 项目

检查注册表中应阻止对指定卷还原操作的编写器。

注意 此函数仅在 Windows Server 操作系统上可用。

 

语法

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

参数

[in] wszVolumeName

卷的名称。 此名称必须使用以下格式之一，并且必须包含尾随反斜杠 (\) ：

  • 装载文件夹的路径，例如 Y：\MountX\
  • 驱动器号，例如 D：\
  • 格式为 \\？\Volume{GUID}\ (的卷 GUID 路径，其中 GUID 标识卷)

[out] pbBlock

指向变量的指针，如果卷包含注册表中作为编写器列出的任何编写器（应阻止还原操作）的组件，则接收 true，否则为 false。

返回值

此函数可以返回其中一个值。

值 含义
S_OK
 函数成功。
E_ACCESSDENIED
 调用方不是管理员。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存不足或其他系统资源。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。

注解

应阻止还原操作的编写器列表存储在注册表中的以下项下：

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

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008、Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
Library VssApi.lib
DLL VssApi.dll