_CrtSetDumpClient
Instalar una función definido por la aplicación para volcar los bloques de memoria del tipo de _CLIENT_BLOCK (versión de depuración solo).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parámetros
- dumpClient
Nueva función definido por cliente de volcado de memoria el enlace en el proceso de volcado de memoria de depuración en tiempo de ejecución de C.
Valor devuelto
Devuelve la función previamente definido del volcado de bloques de cliente.
Comentarios
La función de _CrtSetDumpClient ofrece a aplicación el enlace su propia función para volcar objetos almacenados en bloques de memoria de _CLIENT_BLOCK en el proceso de volcado de memoria de depuración en tiempo de ejecución de C.Como resultado, cada vez que una función de volcado de depuración como _CrtMemDumpAllObjectsSince o _CrtDumpMemoryLeaks vuelca un bloque de memoria de _CLIENT_BLOCK , la función dump de la aplicación se denomina también._CrtSetDumpClient proporciona una aplicación con un método sencillo para detectar pérdidas de memoria y validar o designar el contenido de los datos almacenados en bloques de _CLIENT_BLOCK .Cuando _DEBUG no está definido, las llamadas a _CrtSetDumpClient se quitan durante el preprocesamiento.
La función de _CrtSetDumpClient instala la nueva función definido por la aplicación de volcado de memoria especificada en dumpClient y devuelve la función previamente definido de volcado de memoria.Un ejemplo de una función dump de bloque cliente es como sigue:
void DumpClientFunction( void *userPortion, size_t blockSize );
El argumento de userPortion es un puntero al principio de la parte de datos de usuario del bloque de memoria y blockSize especifica el tamaño del bloque de memoria asignado en bytes.La función dump de bloque cliente debe devolver void.El puntero a la función dump de cliente que se pasa a _CrtSetDumpClient es de _CRT_DUMP_CLIENTescrito, como definido en Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Para obtener un ejemplo de cómo implementar una función definido por la aplicación de volcado, vea ejemplo crt_dbg2: Funciones de enlace de depuración en tiempo de ejecución de C.Para obtener más información sobre las funciones que se usan con _CLIENT_BLOCK escriba los bloques de memoria, vea Funciones de enlace de bloques de cliente.La función de _CrtReportBlockType se puede utilizar para devolver información sobre los tipos y subtipos bloqueados.
Requisitos
rutina |
Encabezado necesario |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
bibliotecas
Versiones de depuración de Bibliotecas en tiempo de ejecución de C únicamente.
Ejemplo
Para obtener un ejemplo de cómo utilizar _CrtSetDumpClient, vea crt_dbg2.
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.