`_CrtMemDumpAllObjectsSince`

Artikel
10/12/2023

Mencadangkan informasi tentang objek dalam timbunan dari awal eksekusi program atau dari status timbunan tertentu (hanya versi debug).

Sintaks

void _CrtMemDumpAllObjectsSince(
   const _CrtMemState *state
);

Parameter

state
Penunjuk ke status timbunan untuk mulai mencadangkan dari atau NULL.

Keterangan

Fungsi ini _CrtMemDumpAllObjectsSince mencadangkan informasi header debug objek yang dialokasikan dalam timbunan dalam bentuk yang dapat dibaca pengguna. Informasi cadangan dapat digunakan oleh aplikasi untuk melacak alokasi dan mendeteksi masalah memori. Jika _DEBUG tidak ditentukan, panggilan ke _CrtMemDumpAllObjectsSince akan dihapus selama praproscesing.

_CrtMemDumpAllObjectsSince menggunakan nilai state parameter untuk menentukan tempat memulai operasi pencadangan. Untuk mulai mencadangkan dari status timbunan tertentu, state parameter harus menjadi penunjuk ke _CrtMemState struktur yang telah diisi oleh _CrtMemCheckpoint sebelumnya _CrtMemDumpAllObjectsSince dipanggil. Ketika state adalah NULL, fungsi memulai dump dari awal eksekusi program.

Jika aplikasi telah menginstal fungsi dump hook dengan memanggil _CrtSetDumpClient, maka setiap kali _CrtMemDumpAllObjectsSince membuang informasi tentang _CLIENT_BLOCK jenis blok, aplikasi juga memanggil fungsi cadangan yang disediakan aplikasi. Secara default, blok run-time C internal (_CRT_BLOCK) tidak disertakan dalam operasi cadangan memori. Fungsi _CrtSetDbgFlag ini dapat digunakan untuk mengaktifkan _CRTDBG_CHECK_CRT_DF bit _crtDbgFlag untuk menyertakan blok-blok ini. Selain itu, blok yang ditandai sebagai dibebaskan atau diabaikan (_FREE_BLOCK, _IGNORE_BLOCK) tidak disertakan dalam cadangan memori.

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.

Persyaratan

Rutin	Header yang diperlukan
_CrtMemDumpAll-ObjectsSince	<crtdbg.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Debug versi pustaka run-time C saja.

Contoh

Untuk sampel cara menggunakan _CrtMemDumpAllObjectsSince, lihat crt_dbg2.