setLogArchiveTail 函式 (clfsw32.h)
設定可封存記錄檔的最後一個封存記錄序號 (LSN) 或 封存結尾 。
語法
CLFSUSER_API BOOL SetLogArchiveTail(
[in] HANDLE hLog,
[in] PCLFS_LSN plsnArchiveTail,
[in, out, optional] LPVOID pReserved
);
參數
[in] hLog
從 CreateLogFile 取得之記錄檔的句柄。
記錄句柄可以參考專用或多任務記錄檔。
[in] plsnArchiveTail
指定記錄中有效實體 LSN 之CLFS_LSN 結構的指標。
注意 對於實體記錄檔或記錄數據流的句柄， plsnArchiveTail 是實體 LSN，因為它參考實體記錄中的記錄位址。
[in, out, optional] pReserved
這個參數是保留的，而且應該設定為 NULL。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
下列清單會識別可能的錯誤碼：
備註
如果從 PrepareLogArchive 取得的任何封存內容未以 TerminateLogArchive 終止，則在完成所有封存之前，變更才會生效。 雖然有未完成的封存內容，但只會套用最大的封存尾。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 R2 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | clfsw32.h |
| 程式庫 | Clfsw32.lib |
| Dll | Clfsw32.dll |