_CrtIsValidHeapPointer

Verifica se um ponteiro especificado está no heap local (versão de depuração somente).

int _CrtIsValidHeapPointer(  
   const void *userData  
);

Parâmetros

• userData
  Ponteiro para o início de um bloco de memória alocada.

Valor de retorno

_CrtIsValidHeapPointer retorna TRUE se o ponteiro está especificado no heap local. Caso contrário, a função retornará FALSE.

Comentários

A função de _CrtIsValidHeapPointer é usada para garantir que um endereço de memória específico seja no heap local. O heap local se refere ao heap criada e gerenciada por uma instância específica da biblioteca de tempo de execução C. Se uma biblioteca de vínculo dinâmico) nativa (DLL) contém um link estático a biblioteca de tempo de execução, tem sua própria instância do heap em tempo de execução e, consequentemente suas próprias o heap, independentemente do heap local do aplicativo. Quando _DEBUG não for definido, as chamadas para _CrtIsValidHeapPointer serão removidos durante pré-processamento.

Como essa função retorna TRUE ou FALSE, pode ser transmitido para um de macros de _ASSERT para criar um mecanismo simples de tratamento de erros de depuração. O exemplo a seguir faz com que uma falha de asserção se o endereço especificado não está localizado no heap local:

_ASSERTE( _CrtIsValidHeapPointer( userData ) );

Para obter mais informações sobre como _CrtIsValidHeapPointer pode ser usado com outras funções e macros de depuração, consulte Macros para relatórios. Para obter informações sobre como os blocos de memória são atribuídos, inicializados, e gerenciados na versão de depuração da heap de base, consulte Detalhes da pilha de depuração CRT.

Requisitos

Rotina	Cabeçalho necessário
_CrtIsValidHeapPointer	<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.

Exemplo

// crt_isvalid.c
/*
 * This program allocates a block of memory using _malloc_dbg
 * and then tests the validity of this memory by calling 
 * _CrtIsMemoryBlock,_CrtIsValidPointer, and _CrtIsValidHeapPointer.
 */

#include <stdio.h>
#include <string.h>
#include <malloc.h>
#include <crtdbg.h>

#define  TRUE   1
#define  FALSE  0

int main( void )
{
        char *my_pointer;

        /* 
         * Call _malloc_dbg to include the filename and line number
         * of our allocation request in the header information
         */
        my_pointer = (char *)_malloc_dbg( sizeof(char) * 10, 
        _NORMAL_BLOCK, __FILE__, __LINE__ );

        // Ensure that the memory got allocated correctly
        _CrtIsMemoryBlock((const void *)my_pointer, sizeof(char) * 10, 
        NULL, NULL, NULL );

         // Test for read/write accessibility
        if (_CrtIsValidPointer((const void *)my_pointer, 
        sizeof(char) * 10, TRUE))
                printf("my_pointer has read and write accessibility.\n");
        else
                printf("my_pointer only has read access.\n");

        // Make sure my_pointer is within the local heap
        if (_CrtIsValidHeapPointer((const void *)my_pointer))
                printf("my_pointer is within the local heap.\n");
        else
                printf("my_pointer is not located within the local"
                       " heap.\n");

        free(my_pointer);
}

Saída

my_pointer has read and write accessibility.
my_pointer is within the local heap.

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.

Consulte também

Referência

Rotinas de depuração