_CrtSetDumpClient
Instala uma função definida pelo aplicativo para despejar _CLIENT_BLOCK digite blocos de memória (somente a versão de depuração).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parâmetros
- dumpClient
Nova função de despejo de memória definidos pelo cliente para conectar-se ao processo de despejo de memória de depuração de tempo de execução C.
Valor de retorno
Retorna o bloco de cliente definida anteriormente despejar a função.
Comentários
O _CrtSetDumpClient função permite que o aplicativo capturar a sua própria função para objetos de despejo, armazenados em _CLIENT_BLOCK blocos de memória para o tempo de execução c depurar o processo de despejo de memória.Como resultado, sempre que uma depuração despejar função, como _CrtMemDumpAllObjectsSince ou _CrtDumpMemoryLeaks Despeja um _CLIENT_BLOCK bloco de memória, a função de despejo do aplicativo é chamada também._CrtSetDumpClientFornece um aplicativo com um método fácil para detecção de vazamentos de memória e validar ou reportar o conteúdo dos dados armazenados em _CLIENT_BLOCK blocos.Quando _ Debug não está definido, planos de _CrtSetDumpClient são removidos durante o pré-processamento.
O _CrtSetDumpClient função instala a nova função de despejo definido pelo aplicativo especificada em dumpClient e retorna a função de despejo previamente definidos.Um exemplo de uma função de despejo de bloco do cliente é o seguinte:
void DumpClientFunction( void *userPortion, size_t blockSize );
O userPortion argumento é um ponteiro para o início da parte de dados do usuário do bloco de memória e blockSize Especifica o tamanho da memória alocada bloquear em bytes.A função de despejo de bloco do cliente deve retornar void.O ponteiro para a função de despejo do cliente que é passado para _CrtSetDumpClient é do tipo _CRT_DUMP_CLIENT, conforme definido em Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Para obter um exemplo de como implementar uma função definida pelo aplicativo de despejo, consulte crt_dbg2 exemplo: depuração de funções de gancho de tempo de execução c.Para obter mais informações sobre as funções que operam em _CLIENT_BLOCK digite blocos de memória, consulte Funções de gancho de bloco do cliente.O _CrtReportBlockType função pode ser usada para retornar informações sobre tipos de bloco e subtipos.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.
Bibliotecas
Versões de depuração de bibliotecas de tempo de execução c somente.
Exemplo
Para obter um exemplo de como usar _CrtSetDumpClient, consulte crt_dbg2.
Equivalência do .NET Framework
Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.