_CrtMemCheckpoint
Mendapatkan status heap 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 heap 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. Ketika _DEBUG tidak ditentukan, panggilan ke _CrtMemState akan dihapus selama praproscessing.
Aplikasi harus meneruskan pointer 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 dari 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_errlistdan _sys_nerr diatur ke EINVAL dan fungsi akan kembali.
Persyaratan
| Rutin | Header yang dibutuhkan |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h>, <errno.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Perpustakaan: Hanya versi debug UCRT.