(dbgeng.h) IDebugControl2::OpenLogFile 方法

OpenLogFile 方法會開啟記錄檔,以接收來自用戶端對象的輸出。

語法

HRESULT OpenLogFile(
  [in] PCSTR File,
  [in] BOOL  Append
);

參數

[in] File

指定記錄檔的名稱。 檔案 可以包含相對或絕對路徑;相對路徑相對於啟動調試程序的目錄。 若檔案不存在,會建立該檔案。

[in] Append

指定是否要將記錄訊息附加至現有的記錄檔。 如果 為 TRUE,則會將記錄訊息附加至檔案;如果 為 FALSE,則會捨棄任何現有檔案符合 檔案 的內容。

傳回值

這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。

備註

OpenLogFileOpenLogFileWide 的行為與 OpenLogFile2OpenLogFile2Wide 的行為相同,如果 AppendTRUE 且DEBUG_LOG_DEFAULT則設定為 DEBUG_LOG_APPEND。

一次只能開啟一個記錄檔。 如果已經開啟記錄檔,則會關閉。

如需記錄檔的詳細資訊,請參閱 使用輸入和輸出

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

.logappend (附加記錄檔)

.logopen (開啟記錄檔)

CloseLogFile

GetLogFile

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile2

SetLogMask