Leggere in inglese

Condividi tramite


_CrtIsMemoryBlock

Verifica che un blocco di memoria specificato sia nell'heap locale con un identificatore valido del tipo di blocco dell'heap di debug (solo versione di debug).

int _CrtIsMemoryBlock( 
   const void *userData,
   unsigned int size,
   long *requestNumber,
   char **filename,
   int *linenumber 
);

Parametri

  • [in] userData
    Puntatore all'inizio del blocco di memoria da verificare.

  • [in] size
    Dimensione del blocco specificato (in byte).

  • [out] requestNumber
    Puntatore al numero di allocazione del blocco o NULL.

  • [out] filename
    Puntatore al nome del file di origine che ha richiesto il blocco o NULL.

  • [out] linenumber
    Puntatore al numero di riga nel file di origine o in NULL.

Valore restituito

_CrtIsMemoryBlock restituisce TRUE se il blocco di memoria specificato si trova all'interno dell'heap locale e presenta un identificatore valido del tipo di blocco dell'heap di debug; in caso contrario, la funzione restituisce FALSE.

Note

La funzione _CrtIsMemoryBlock verifica che un blocco di memoria specificato sia presente nell'heap locale dell'applicazione con un identificatore valido a blocchi. Questa funzione può essere utilizzata per ottenere il numero di ordini di allocazione di oggetti, il nome del file di origine e il numero di riga in cui è stata richiesta l'allocazione del blocco di memoria. Il passaggio di valori non NULL per requestNumber, filename, o per parametri linenumber permette a _CrtIsMemoryBlock di impostare questi parametri ai valori nell'header di debug del blocco di memoria, se trova il blocco dell'heap locale. Quando _DEBUG non è definito, le chiamate a _CrtIsMemoryBlock vengono rimosse durante la pre-elaborazione.

Se _CrtIsMemoryBlock fallisce, restituisce FALSE e i parametri di output vengono inizializzati ai valori predefiniti: requestNumber e lineNumber vengono impostate su 0 e filename su NULL.

Poiché la funzione restituisce TRUE o FALSE, può essere passata a una delle macro _ASSERT per creare un semplice meccanismo di gestione degli errori di debug. L'esempio seguente genera un errore di asserzione se l'indirizzo specificato non si trova nell'heap locale:

_ASSERTE( _CrtIsMemoryBlock( userData, size, &requestNumber, 
&filename, &linenumber ) );

Per ulteriori informazioni su come _CrtIsMemoryBlock può essere utilizzato da altre funzioni e macro di debug, consultare Macro per la creazione di rapporti. Per informazioni su come i blocchi di memoria allocati, vengono inizializzati e vengono gestiti nella versione di debug dell'heap di base, vedere Informazioni dettagliate sull'heap di debug CRT.

Requisiti

Routine

Intestazione obbligatoria

_CrtIsMemoryBlock

<crtdbg.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Librerie

Solo versioni di debug di Librerie di runtime C.

Esempio

Consultare l'esempio per l'argomento _CrtIsValidHeapPointer.

Equivalente .NET Framework

Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.

Vedere anche

Riferimenti

Routine di debug