_CrtMemCheckpoint

Mendapatkan status tumpukan debug saat ini dan menyimpan dalam struktur yang disediakan _CrtMemState aplikasi (hanya versi debug).

Sintaks

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parameter

state
Penunjuk ke _CrtMemState struktur untuk mengisi dengan titik pemeriksaan memori.

Keterangan

Fungsi ini _CrtMemCheckpoint membuat rekam jepret dari status timbunan debug saat ini pada saat tertentu. Rekam jepret ini dapat digunakan oleh fungsi status timbunan lainnya seperti _CrtMemDifference untuk membantu mendeteksi kebocoran memori dan masalah lainnya. Jika _DEBUG tidak ditentukan, panggilan ke _CrtMemState akan dihapus selama praproscesing.

Aplikasi harus meneruskan penunjuk ke instans _CrtMemState struktur yang dialokasikan sebelumnya, yang ditentukan dalam Crtdbg.h, dalam state parameter . Jika _CrtMemCheckpoint mengalami kesalahan selama pembuatan titik pemeriksaan, fungsi menghasilkan laporan debug yang _CRT_WARN menjelaskan masalahnya.

Untuk informasi selengkapnya tentang fungsi status timbunan dan _CrtMemState struktur, lihat Fungsi pelaporan status timbunan. Untuk informasi selengkapnya tentang bagaimana blok memori dialokasikan, diinisialisasi, dan dikelola dalam versi debug timbunan dasar, lihat detail timbunan debug CRT.

Jika state adalah NULL, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, , errno, _doserrno_sys_errlist, dan _sys_nerr diatur ke EINVAL dan fungsi akan kembali.

Persyaratan

Rutin	Header yang diperlukan
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka: Hanya versi debug UCRT.

Baca juga

Rutinitas debug
_CrtMemDifference