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

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

構文

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

[in] File

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

[in] Append

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

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

リターンコード	形容
S_OK	メソッドが成功しました。

OpenLogFile と openLogFileWide は、OpenLogFile2 と同じように動作し、フラグを持つ OpenLogFile2Wide 追加が TRUE 、それ以外の場合はDEBUG_LOG_DEFAULT DEBUG_LOG_APPENDに設定。

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

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

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)