_CrtMemCheckpoint
获取调试堆和存储的当前状态一个由应用程序提供的 _CrtMemState 结构 (请只调试版本)。
void _CrtMemCheckpoint(
_CrtMemState *state
);
参数
- state
对于加载的 _CrtMemState 结构的指针使用内存检查点。
备注
_CrtMemCheckpoint 函数在指定的任何时间创建调试堆的当前状态的快照。 此快照可由其他堆态函数用于例如 _CrtMemCheckpoint 帮助检测内存泄漏及其他问题。 当 _DEBUG 未定义时,在预处理期间,对 _CrtMemState 中移除。
应用程序必须通过指向 _CrtMemState 结构的以前指定的实例,定义在 Crtdbg.h,在 state 参数。 如果 _CrtMemCheckpoint 在检查点创建时遇到错误,函数生成 _CRT_WARN 调试描述问题的报表。
有关堆态函数和 _CrtMemState framework 的更多信息,请参见 堆状态报告函数。 有关如何安装的更多信息存储在基堆的调试版本中分配,初始化,并管理,请参见 内存管理和调试堆。
如果 state 是 NULL,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续, errno、_doserrno、_sys_errlist和_sys_nerr 设置为 EINVAL ,函数返回。
要求
实例 |
必需的头 |
---|---|
_CrtMemCheckpoint |
crtdbg.h, errno.h |
有关更多兼容性信息,请参见中介绍的 兼容性 。
库: 只调试 CRT库功能 的版本。
示例
请参见 crt_dbg1。
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例。