_CrtSetDumpClient

Instala una función definida por la aplicación para volcar bloques de memoria de tipo _CLIENT_BLOCK (solo versión de depuración).

Sintaxis

_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );

Parámetros

dumpClient
Nueva función de volcado de memoria definida por el cliente para enlazar.

Valor devuelto

Devuelve la función previamente definida de volcado de bloques de cliente.

Comentarios

La _CrtSetDumpClient función permite a la aplicación enlazar su propia función para volcar objetos almacenados en _CLIENT_BLOCK bloques de memoria. Como resultado, cada vez que una función de volcado de depuración, como _CrtMemDumpAllObjectsSince o _CrtDumpMemoryLeaks volcado de _CLIENT_BLOCK memoria, también se llama a la función de volcado de memoria de la aplicación. _CrtSetDumpClient proporciona a una aplicación un método sencillo para detectar pérdidas de memoria, y validar o notificar el contenido de los datos almacenados en bloques _CLIENT_BLOCK. Cuando _DEBUG no se define, las llamadas a _CrtSetDumpClient se quitan durante el preprocesamiento.

La función _CrtSetDumpClient instala la nueva función de volcado definida por la aplicación especificada en dumpClient y devuelve la función de volcado definida previamente. Ejemplo de una función de volcado de bloque de cliente:

void DumpClientFunction( void *userPortion, size_t blockSize );

El argumento userPortion es un puntero al principio de la parte de datos del usuario del bloque de memoria y blockSize especifica en bytes el tamaño del bloque de memoria asignado. La función de volcado de bloque de cliente debe devolver void. El puntero a la función de volcado de cliente que se pasa a _CrtSetDumpClient es del tipo _CRT_DUMP_CLIENT, según se define en Crtdbg.h:

typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );

Para obtener más información sobre las funciones que operan en _CLIENT_BLOCK bloques de memoria de tipo, consulte Funciones de enlace de bloques de cliente. La _CrtReportBlockType función se puede usar para devolver información sobre los tipos de bloques y subtipos.

Requisitos

Routine	Encabezado necesario
_CrtSetDumpClient	<crtdbg.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Solo versiones de depuración de las bibliotecas en tiempo de ejecución de C.

Consulte también

Rutinas de depuración
_CrtReportBlockType
_CrtGetDumpClient