iLog::Force 方法 (txlogpub.h)
強制記錄檔的內容到磁片,至少會透過指定的 LSN。
語法
HRESULT Force(
[in] LSN lsnMinToForce
);
參數
[in] lsnMinToForce
至少,尚未寫入 LSN 小於或等於 lsnMinToForce 之磁片的所有記錄現在都必須寫入磁片。 不過,實作可能會選擇寫入比絕對必要更多的記錄。 例如,不論 lsnMinToForce的值為何,都允許實作強制將所有記錄都寫入磁片。 以 lsnMinToForce 傳遞 0 表示整個記錄檔會強制磁片。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
附加個別記錄之後,記錄檔也可能強制磁片。 請參閱 ILog::AppendRecord。
來電者附注
失敗傳回值表示自上次成功強制強制後附加至記錄的任何記錄不保證在磁片上。 ILog介面不提供方法來判斷哪些記錄已成功寫入磁片。 如果您需要知道哪些記錄已成功寫入磁片,您必須強制每個記錄的記錄。 請參閱 ILog::AppendRecord。實作者的注意事項
例如,建議您先使用 FlushFileBuffers 函式) ,再從此方法傳回之前,先排清檔案緩衝區 (。需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | txlogpub.h |