日志记录清单概述

日志记录清单是一组“头文件”，用于定义拦截和记录的函数和 COM 接口。 这些并不是真正的 C++ 头文件 - 它们的格式略有不同，明确声明了日志程序所需的信息。

例如，清单格式具有以下功能：

• 指定 OUT 参数。 这些参数在进入函数和离开函数时都应被记录。

• 标志掩码的定义。 此功能允许日志查看器将 DWORD 标志分解为其组成的位标签，以便于阅读。

• 故障案例的定义。 此功能允许日志查看器让返回失败状态代码或其他错误代码的函数行显示为阴影。 此外，如果函数设置了线程的“LastError”值，日志查看器就可以存储错误代码，并将其扩展为相应的人类可读错误信息。

• 指定可为日志差异指定别名的参数。 该功能可让日志查看器在将数据导出到文件时，选择将常量字符串赋值给一个在不同执行过程中会发生变化的值，如指针和句柄。 然后，可以使用差异工具来比较两个执行日志，从而找出差异。 如果未对指针和句柄值进行别名处理，那么在比较两个文件时就会产生没有意义的差异。