IDebugControl2::GetLogFile 方法 (dbgeng.h)

GetLogFile 方法會傳回目前開啟的記錄檔名稱。

語法

HRESULT GetLogFile(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG FileSize,
  [out]           PBOOL  Append
);

參數

[out, optional] Buffer

接收目前開啟之記錄檔的名稱。 如果 BufferNULL,則不會傳回這項資訊。

[in] BufferSize

指定 緩衝區 緩衝區的大小,以字元為單位。

[out, optional] FileSize

接收記錄檔名稱的大小,以字元為單位。 如果 FileSizeNULL,則不會傳回這項資訊。

[out] Append

如果記錄訊息附加至記錄檔,則收到 TRUE ;如果檔案開啟時捨棄記錄檔的內容,則為 FALSE

傳回值

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

傳回碼 描述
S_OK
此方法成功。
S_FALSE
此方法成功。 不過,記錄檔的名稱太長而無法放入 緩衝區 緩衝區中,因此名稱已截斷。
E_NOINTERFACE
目前沒有開啟的記錄檔。

備註

GetLogFileGetLogFileWide 的行為與 GetLogFile2GetLogFile2Wide 相同, 且 Append 只會接收DEBUG_LOG_APPEND旗標的相關信息。

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

規格需求

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

另請參閱

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile