JetStopBackup 函数

适用于： Windows |Windows Server

JetStopBackup 函数

JetStopBackup 函数可防止任何流式备份相关活动在特定正在运行的实例上继续，从而以可预测的方式结束流式备份。

Windowsxp： 此函数在 Windows XP 中引入。

JetStopService 是仅允许一个实例时的旧调用。 在这种情况下，唯一的活动实例是准备终止的实例。

JET_ERR JET_API JetStopBackup(void);

parameters

此函数没有参数。

返回值

此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息，请参阅 可扩展存储引擎错误 和 错误处理参数。

返回代码	说明
JET_errSuccess	操作已成功完成。
JET_errRunningInMultiInstanceMode	使用具有多个实例模式的 JetStopService 时，不清楚哪个实例要准备终止。 Windowsxp： 此返回值在 Windows XP 中引入。

如果此函数成功，实例将开始失败任何新的流式备份 API。

如果此函数失败，则不会执行任何步骤来准备实例上的备份终止，并且不会更改实例状态。

备注

备份通常由进程机制外部的事件触发，并且使用此 API，ESENT 应用程序本身将进一步调用流式备份 API 失败。 大多数流式备份 API 将开始失败，JET_errBackupAbortByServer。 因此，任何流式备份进度 (（如 JetReadFileInstance) ）都将返回错误。 仍允许备份终止 (的备份操作，例如 JetEndExternalBackupInstance) 。

要求

要求	值
客户端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。
Library	使用 ESENT.lib。
DLL	需要ESENT.dll。

另请参阅

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService