IDebugControl4：：OpenLogFile2 方法 (dbgeng.h)

OpenLogFile2 方法打开一个日志文件，该日志文件将接收来自客户端对象的输出。

语法

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

[in] File

指定日志文件的名称。文件可以包含相对路径或绝对路径;相对路径相对于启动调试器的目录。如果该文件不存在，则会创建该文件。

[in] Flags

指定控制日志文件性质的位标志。标志可以包含下表中的标志。

标志	设置时的效果
DEBUG_LOG_APPEND	输出将追加到日志文件，而不是放弃日志文件的内容。
DEBUG_LOG_UNICODE	日志文件的格式将为 Unicode 而不是 ASCII。

或者，对于不包含任何标志的默认选项集，可以将标志设置为DEBUG_LOG_DEFAULT。

此方法还可以返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。

一次只能打开一个日志文件。如果已打开日志文件，则会将其关闭。

有关日志文件的详细信息，请参阅使用输入和输出。

要求	值
目标平台	桌面
标头	dbgeng.h (包括 Dbgeng.h)