_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.