_CrtSetBreakAlloc

Imposta un punto di interruzione su un numero di ordine di allocazione dell'oggetto (solo versione di debug).

Sintassi

long _CrtSetBreakAlloc(
   long lBreakAlloc
);

Parametri

lBreakAlloc
Numero di ordine di allocazione per il quale impostare il punto di interruzione.

Valore restituito

Restituisce il precedente numero di ordine di allocazione dell'oggetto che presentava un punto di interruzione impostato.

Osservazioni:

_CrtSetBreakAlloc consente a un'applicazione di eseguire il rilevamento della perdita di memoria eseguendo l'interruzione in un punto specifico dell'allocazione di memoria e risalendo all'origine della richiesta. La funzione usa il numero di ordine di allocazione dell'oggetto assegnato al blocco di memoria al momento dell'allocazione nell'heap. Quando _DEBUG non è definito, le chiamate a _CrtSetBreakAlloc vengono rimosse durante la pre-elaborazione.

Il numero dell'ordine di allocazione dell'oggetto viene archiviato nel lRequest campo della _CrtMemBlockHeader struttura, definito in Crtdbg.h. Quando le informazioni su un blocco di memoria vengono segnalate da una delle funzioni di dump di debug, questo numero è racchiuso tra parentesi graffe, ad esempio {36}.

Per altre informazioni su come _CrtSetBreakAlloc usare con altre funzioni di gestione della memoria, vedere Rilevamento delle richieste di allocazione dell'heap. Per altre informazioni sulla modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Dettagli dell'heap di debug CRT.

Requisiti

Ciclo	Intestazione obbligatoria
_CrtSetBreakAlloc	<crtdbg.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Solo le versioni di debug delle librerie di runtime di C.

Esempio

// crt_setbrkal.c
// compile with: -D_DEBUG /MTd -Od -Zi -W3 /c /link -verbose:lib -debug

/*
* In this program, a call is made to the _CrtSetBreakAlloc routine
* to verify that the debugger halts program execution when it reaches
* a specified allocation number.
*/

#include <malloc.h>
#include <crtdbg.h>

int main( )
{
        long allocReqNum;
        char *my_pointer;

        /*
         * Allocate "my_pointer" for the first
         * time and ensure that it gets allocated correctly
         */
        my_pointer = malloc(10);
        _CrtIsMemoryBlock(my_pointer, 10, &allocReqNum, NULL, NULL);

        /*
         * Set a breakpoint on the allocation request
         * number for "my_pointer"
         */
        _CrtSetBreakAlloc(allocReqNum+2);

        /*
         * Alternate freeing and reallocating "my_pointer"
         * to verify that the debugger halts program execution
         * when it reaches the allocation request
         */
        free(my_pointer);
        my_pointer = malloc(10);
        free(my_pointer);
        my_pointer = malloc(10);
        free(my_pointer);
}

Vedi anche

Routine di debug