IDebugControl4::OpenLogFile2 メソッド (dbgeng.h)

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

構文

HRESULT OpenLogFile2(
  [in] PCSTR File,
  [in] ULONG Flags
);

[in] File

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

[in] Flags

ログファイルの性質を制御するビットフラグを指定します。 Flags には、次の表のフラグを含めることができます。

旗	設定時の効果
DEBUG_LOG_APPEND	出力は、ログファイルの内容を破棄するのではなく、ログファイルに追加されます。
DEBUG_LOG_UNICODE	ログファイルの形式は、ASCII ではなく Unicode になります。

または、フラグ を、フラグを含む既定のオプションセットに対してDEBUG_LOG_DEFAULTに設定できます。

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

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

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

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

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