_CrtMemDumpAllObjectsSince

Membuang informasi tentang objek dalam tumpukan 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 heap dalam bentuk yang dapat dibaca pengguna. Informasi cadangan dapat digunakan oleh aplikasi untuk melacak alokasi dan mendeteksi masalah memori. Ketika _DEBUG tidak ditentukan, panggilan ke _CrtMemDumpAllObjectsSince akan dihapus selama praproscessing.

_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 dump yang disediakan aplikasi. Secara default, blok run-time C internal (_CRT_BLOCK) tidak disertakan dalam operasi cadangan memori. Fungsi ini _CrtSetDbgFlag 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 dari timbunan dasar, lihat detail timbunan debug CRT.

Persyaratan

Rutin Header yang dibutuhkan
_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.

Lihat juga

Rutinitas debug
_crtDbgFlag