IDebugControl3::OpenLogFile メソッド (dbgeng.h)
OpenLogFile メソッドは、クライアント オブジェクトからの出力を受け取るログ ファイルを開きます。
構文
HRESULT OpenLogFile(
[in] PCSTR File,
[in] BOOL Append
);
パラメーター
[in] File
ログ ファイルの名前を指定します。 ファイル には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。 ファイルが存在しない場合は、作成されます。
[in] Append
ログ メッセージを既存のログ ファイルに追加するかどうかを指定します。 TRUE の場合、ログ メッセージがファイルに追加されます。FALSE の場合、File と一致する既存のファイルの内容は破棄されます。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
注釈
OpenLogFile と OpenLogFileWide は、OpenLogFile2 および OpenLogFile2Wide と同じように動作し、Append が TRUE の場合はフラグを DEBUG_LOG_APPEND に設定し、それ以外の場合はDEBUG_LOG_DEFAULT。
一度に開くことができるログ ファイルは 1 つだけです。 既にログ ファイルが開いている場合は、閉じられます。
ログ ファイルの詳細については、「 入力と出力の使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | dbgeng.h (Dbgeng.h を含む) |