适用于: Windows |Windows Server
JetOSSnapshotTruncateLog 函数
JetOSSnapshotTruncateLog 函数为属于快照会话的所有实例启用日志截断。
Windows Vista:JetOSSnapshotTruncateLog 在 Windows Vista 中引入。
    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );
parameters
snapId
快照会话的标识符。
grbit
此调用的选项。 此参数可以具有以下值的组合。
| 值 | 含义 | 
|---|---|
| JET_bitAllDatabasesSnapshot | 所有数据库都附加,因此存储引擎可以计算并执行日志截断。 | 
| 0(零) | 不会发生截断。 | 
返回值
此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息,请参阅 可扩展存储引擎错误 和 错误处理参数。
| 返回代码 | 说明 | 
|---|---|
| JET_errSuccess | 操作已成功完成。 | 
| JET_errInvalidGrbit | grbit 参数无效。 | 
| JET_errOSSnapshotInvalidSequence | 快照会话不处于可能发生截断的状态。 可能的原因包括: 
 | 
成功后,如果可能,快照会话的一个或所有实例部分的日志文件将被截断。
备注
仅当使用 JET_bitContinueAfterThaw 选项创建快照时,才应调用此函数。 否则,快照会话将在 JetOSSnapshotThaw 调用后结束。
要求
| 要求 | 值 | 
|---|---|
| 客户端 | 需要 Windows Vista。 | 
| 服务器 | 需要 Windows Server 2008。 | 
| 标头 | 在 Esent.h 中声明。 | 
| Library | 使用 ESENT.lib。 | 
| DLL | 需要ESENT.dll。 | 
另请参阅
              错误处理参数
              可扩展存储引擎错误
              JET_ERR
              JetOSSnapshotEnd
              JetOSSnapshotFreeze
              JetOSSnapshotPrepare
              JetOSSnapshotThaw