_CrtSetDumpClient
Instala uma função de aplicativo definida para despejar blocos de memória do tipo de _CLIENT_BLOCK (versão de depuração somente).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parâmetros
- dumpClient
Nova função definida pelo cliente de despejo de memória para conectar no processo de despejo de memória de depuração de tempo de execução C.
Valor de retorno
Retorna a função definida anteriormente de despejo do bloco de cliente.
Comentários
A função de _CrtSetDumpClient permite que o aplicativo conectar sua própria função para despejar os objetos armazenados em blocos de memória de _CLIENT_BLOCK no processo de despejo de memória de depuração de tempo de execução C. No resultado, todas as vezes em uma função de despejo de depuração como _CrtMemDumpAllObjectsSince ou _CrtDumpMemoryLeaks for um bloco de memória de _CLIENT_BLOCK , a função de despejo de aplicativo é chamada também. _CrtSetDumpClient fornece um aplicativo com um método fácil para detectar possíveis vazamentos de memória e validar ou relatar o conteúdo dos dados armazenados em blocos de _CLIENT_BLOCK . Quando _DEBUG não for definido, as chamadas para _CrtSetDumpClient serão removidos durante pré-processamento.
A função de _CrtSetDumpClient instalar a nova função de aplicativo definida de despejo especificada em dumpClient e retorna a função definida anteriormente de despejo. Um exemplo de uma função de despejo do bloco de cliente é a seguinte:
void DumpClientFunction( void *userPortion, size_t blockSize );
O argumento de userPortion é um ponteiro para o início da parte de dados de usuário do bloco de memória e blockSize especifica o tamanho do bloco de memória alocado em bytes. A função de despejo do bloco do cliente deve retornar void. O ponteiro da função de despejo do cliente que é passada a _CrtSetDumpClient é do tipo _CRT_DUMP_CLIENT, conforme definido em Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Para obter mais informações sobre as funções que operam em blocos de memória do tipo de _CLIENT_BLOCK , consulte Funções de gancho do bloco de clientes. A função de _CrtReportBlockType pode ser usada para retornar informações sobre tipos e subtipos do bloco.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.
Bibliotecas
Versões de depuração das Bibliotecas em tempo de execução C somente.
Equivalência do .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.