_CrtIsMemoryBlock
Verifica se um bloco de memória especificado está no heap local e se ele tem um identificador de tipo de bloco de heap de depuração válido (somente versão de depuração).
Sintaxe
int _CrtIsMemoryBlock(
const void *userData,
unsigned int size,
long *requestNumber,
char **filename,
int *lineNumber
);
Parâmetros
userData
Ponteiro para o início do bloco de memória a ser verificado.
size
Tamanho do bloco especificado (em bytes).
requestNumber
Ponteiro para o número de alocação do bloco ou NULL.
filename
Ponteiro para o nome do arquivo de origem que solicitou o bloco ou NULL.
lineNumber
Ponteiro para o número de linha no arquivo de origem ou NULL.
Valor retornado
_CrtIsMemoryBlock retornará TRUE se o bloco de memória especificado estiver localizado no heap local e tiver um identificador de tipo de bloco de heap de depuração válido; caso contrário, a função retornará FALSE.
Comentários
A função _CrtIsMemoryBlock verifica se um bloco de memória especificado está localizado no heap local do aplicativo e se ele tem um identificador de tipo de bloco válido. Essa função também pode ser usada para obter o número de ordem de alocação do objeto e o nome do arquivo de origem/número de linha em que a alocação de bloco de memória foi originalmente solicitada. Um nãoNULL valor passado em um requestNumberparâmetro , filename, or lineNumber faz com que _CrtIsMemoryBlock o parâmetro seja definido como o valor no cabeçalho de depuração do bloco de memória, se ele encontrar o bloco no heap local. Quando _DEBUG não está definido, as chamadas para _CrtIsMemoryBlock são removidas durante o pré-processamento.
Se _CrtIsMemoryBlock falhar, ele retornará FALSE, e os parâmetros de saída serão inicializados com os valores padrão: requestNumber e lineNumber são definidos como 0 e filename são definidos como NULL.
Como essa função retorna TRUE ou FALSE, ela pode ser passada para uma das macros para criar um mecanismo básico de tratamento de _ASSERT erros de depuração. O seguinte exemplo causa uma falha de declaração se o endereço especificado não estiver localizado no heap local:
_ASSERTE( _CrtIsMemoryBlock( userData, size, &requestNumber,
&filename, &linenumber ) );
Para obter mais informações sobre como _CrtIsMemoryBlock pode ser usado com outras funções de depuração e macros, consulte Macros para relatórios. Para obter informações sobre como os blocos de memória são alocados, inicializados e gerenciados na versão de depuração do heap base, consulte Detalhes do heap de depuração do CRT.
Requisitos
| Rotina | Cabeçalho necessário |
|---|---|
_CrtIsMemoryBlock |
<crtdbg.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Bibliotecas
Somente versões de depuração de bibliotecas de tempo de execução C.
Exemplo
Veja o exemplo do _CrtIsValidHeapPointer artigo.