DeleteLogByHandle 函式 (clfsw32.h)
標記要刪除的指定記錄檔。 當記錄檔的所有句柄、封送處理區域和讀取內容關閉時，就會實際刪除記錄檔。 如果記錄檔是實體記錄檔，則會刪除其基礎容器。
當記錄標示為要刪除時，開啟新用戶端記錄數據流的要求會失敗。
注意 此函式與 DeleteLogFile 不同，因為它會接受有效的記錄對象開啟句柄，而不是記錄名稱。
語法
CLFSUSER_API BOOL DeleteLogByHandle(
[in] HANDLE hLog
);
參數
[in] hLog
成功呼叫 CreateLogFile 所取得之開啟記錄檔的句柄。 記錄必須已使用 DELETE 存取權建立，否則您無法刪除記錄檔。
傳回值
如果函式成功，則傳回非零的值。
如果函式失敗，傳回值會是零 (0) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 下列清單會識別可能的錯誤碼：
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | clfsw32.h |
| 程式庫 | Clfsw32.lib |
| Dll | Clfsw32.dll |