IDebugControl3::OpenLogFile メソッド (dbgeng.h)

  • [アーティクル]

OpenLogFile メソッドは、クライアント オブジェクトからの出力を受け取るログ ファイルを開きます。

構文

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

パラメーター

[in] File

ログ ファイルの名前を指定します。 ファイル には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。 ファイルが存在しない場合は、作成されます。

[in] Append

ログ メッセージを既存のログ ファイルに追加するかどうかを指定します。 TRUE の場合、ログ メッセージがファイルに追加されます。FALSE の場合、File と一致する既存のファイルの内容は破棄されます。

戻り値

このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。

リターン コード 説明
S_OK
 メソッドは正常に実行されました。

注釈

OpenLogFile と OpenLogFileWide は、OpenLogFile2 および OpenLogFile2Wide と同じように動作し、Append が TRUE の場合はフラグを DEBUG_LOG_APPEND に設定し、それ以外の場合はDEBUG_LOG_DEFAULT。

一度に開くことができるログ ファイルは 1 つだけです。 既にログ ファイルが開いている場合は、閉じられます。

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

要件

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

こちらもご覧ください

.logappend (ログ ファイルの追加)

.logopen (ログ ファイルを開く)

CloseLogFile

GetLogFile

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile2

SetLogMask