_CrtIsMemoryBlock

 

Publicado: julio de 2016

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Comprueba que un bloque de memoria especificado está en el montón local y que tiene un identificador válido de tipo de bloque del montón de depuración (solo versión de depuración).

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

Parámetros

[in] userData
Puntero al principio del bloque de memoria que se va a comprobar.

[in] size
Tamaño del bloque especificado, en bytes.

[out] requestNumber
Puntero al número de asignación del bloque o NULL.

[out] filename
Puntero al nombre del archivo de código fuente que solicitó el bloque o NULL.

[out] linenumber
Puntero al número de línea del archivo de código fuente o NULL.

_CrtIsMemoryBlockDevuelve TRUE si el bloque de memoria especificado se encuentra en el montón local y tiene un identificador de tipo de bloque del montón de depuración válido; en caso contrario, la función devuelve FALSE.

La función _CrtIsMemoryBlock comprueba que un bloque de memoria especificado está en el montón local de la aplicación y que tiene un identificador de tipo de bloque válido. Esta función también se puede usar para obtener el número de orden de la asignación de objetos, y el nombre y el número de línea del archivo de código fuente en el que se solicitó la asignación del bloque de memoria originalmente. Si se pasan valores no nulos para los parámetros requestNumber, filename o linenumber, _CrtIsMemoryBlock establece estos parámetros en los valores del encabezado de depuración del bloque de memoria, si encuentra el bloque en el montón local. Cuando _DEBUG no está definido, las llamadas a _CrtIsMemoryBlock se quitan durante el preprocesamiento.

Si _CrtIsMemoryBlock produce un error, devuelve FALSE y los parámetros de salida se inicializan con los valores predeterminados: requestNumber y lineNumber se establecen en 0 y filename se establece en NULL.

Dado que esta función devuelve TRUE o FALSE, se puede pasar a uno de los _ASSERT macros para crear un sencillo mecanismo de control de errores de depuración. En el ejemplo siguiente se genera un error de aserción si la dirección especificada no se está en el montón local:

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

Para obtener más información acerca de cómo _CrtIsMemoryBlock puede utilizarse con otras funciones de depuración y macros, consulte Macros para informes. Para obtener información sobre cómo se asignan, inicializan y administran los bloques de memoria en la versión de depuración del montón base, vea CRT Debug Heap Details.

RutinaEncabezado necesario
_CrtIsMemoryBlock<crtdbg.h>

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

Versiones de depuración de bibliotecas en tiempo de ejecución de C solo.

Vea el ejemplo de la _CrtIsValidHeapPointer tema.

No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Rutinas de depuración

Mostrar: