_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.