IVssBackupComponents：:D isableWriterInstances 方法 (vsbackup.h)
DisableWriterInstances 方法禁用指定的编写器实例。
语法
HRESULT DisableWriterInstances(
[in] const VSS_ID *rgWriterInstanceId,
[in] UINT cInstanceId
);
参数
[in] rgWriterInstanceId
包含一个或多个编写器实例标识符的数组。
[in] cInstanceId
rgWriterInstanceId 数组中的条目数。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
已成功启用编写器类。 |
|
调用方没有足够的备份权限或不是管理员。 |
|
调用方内存不足或其他系统资源。 |
|
备份组件对象未初始化，在还原操作期间调用了此方法，或者尚未在正确的顺序中调用此方法。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。 |
注解
如果你有同一编写器的多个正在运行的副本，它们都将具有相同的编写器类标识符，但它们将具有不同的编写器实例标识符。 禁用编写器的一个实例不会导致禁用编写器的其他实例。
如果调用 DisableWriterInstances，则必须在调用 IVssBackupComponents：：GatherWriterMetadata 方法之前执行此操作。 如果先调用 GatherWriterMetadata ，然后调用 DisableWriterInstances，则对 DisableWriterInstances 的 调用不起作用。 如果需要首先调用 GatherWriterMetadata ，若要确定要禁用的编写器实例，则必须从 IVssBackupComponents 接口的其他实例调用它。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| Library | VssApi.lib |
另请参阅
IVssBackupComponents：:D isableWriterClasses