IDebugControl3::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、GetLogFile2 および GetLogFile2Wide と同じように動作し、Append は DEBUG_LOG_APPEND フラグに関する情報のみを受け取ります。

ログ ファイルの詳細については、「 入力と出力の使用」を参照してください。

要件

要件
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile