_CrtMemCheckpoint
取得偵錯堆積的目前狀態，並將儲存在應用程式提供**_CrtMemState**結構 (偵錯版本)。
void _CrtMemCheckpoint(
_CrtMemState *state
);
參數
- state
指標**_CrtMemState**結構，以使用記憶體的檢查點來填滿。
備註
_CrtMemCheckpoint函式會建立於任何指定時間的偵錯堆積的目前狀態的快照集。 這個快照集可供其他堆積狀態功能，例如_CrtMemCheckpoint來幫助偵測記憶體遺漏和其他問題。 當_DEBUG尚未定義，會呼叫**_CrtMemState**在前置處理過程中移除。
應用程式必須將指標傳遞至先前配置的執行個體的**_CrtMemState** Crtdbg.h，在定義中的結構state參數。 如果**_CrtMemCheckpoint遇到錯誤，檢查點建立時，函式會產生_CRT_WARN**偵錯描述問題的報告。
如需有關堆積狀態函式和**_CrtMemState**結構，請參閱堆積狀態報告函式。 如需有關如何記憶體區塊會配置、 初始化，而且在基底堆積的偵錯版本管理的詳細資訊，請參閱記憶體管理和偵錯堆積。
如果state是NULL，不正確的參數處理常式會叫用，如所述參數驗證。 如果要繼續，請允許執行errno、 _doserrno、 _sys_errlist 和 _sys_nerr設定為 [ EINVAL ，並在函式傳回。
需求
常式 |
所需的標頭 |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h>，<errno.h> |
如需相容性資訊，請參閱相容性在簡介中。
定義函數庫: 的偵錯版本CRT 程式庫功能只。
範例
請參閱 crt_dbg1。
.NET Framework 對等用法
不適用。 若要呼叫標準的 c 函式，使用PInvoke。 如需詳細資訊，請參閱 平台叫用範例。