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

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

構文

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

[in] File

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

[in] Flags

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

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

または、 フラグ が含まれていない既定のオプションセットに対して、フラグを DEBUG_LOG_DEFAULT に設定することもできます。

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

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

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

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

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