IDebugControl::GetLogFile 方法 (dbgeng.h)
GetLogFile 方法返回当前打开的日志文件的名称。
语法
HRESULT GetLogFile(
[out, optional] PSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG FileSize,
[out] PBOOL Append
);
参数
[out, optional] Buffer
接收当前打开的日志文件的名称。 如果 缓冲区NULL,则不会返回此信息。
[in] BufferSize
指定 缓冲区 缓冲区的大小(以字符为单位)。
[out, optional] FileSize
接收日志文件名称的大小(以字符为单位)。 如果 FileSizeNULL,则不会返回此信息。
[out] Append
如果日志消息追加到日志文件中,则接收 TRUE;如果打开文件时放弃日志文件的内容,则 FALSE。
返回值
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
|
该方法成功。 但是,日志文件的名称太长,无法容纳在 缓冲区 缓冲区中,以便截断该名称。 |
|
当前没有打开的日志文件。 |
言论
GetLogFile 和 GetLogFileWide 的行为方式与 GetLogFile2 和 GetLogFile2Wide 相同,Append 仅接收有关DEBUG_LOG_APPEND标志的信息。
有关日志文件的详细信息,请参阅 使用输入和输出。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |