_CrtIsValidPointer

Проверяет, что указатель не имеет значения NULL. В версиях библиотеки времени выполнения языка C, выпущенных до выхода Visual Studio 2010, проверяет, является ли указанный диапазон памяти допустимым для чтения и записи (только отладочная версия).

Синтаксис

int _CrtIsValidPointer(
   const void *address,
   unsigned int size,
   int access
);

Параметры

address
Указывает начало диапазона памяти для проверки.

size
Размер указанного диапазона памяти (в байтах).

access
Доступ на чтение или запись для определения диапазона памяти.

Возвращаемое значение

_CrtIsValidPointer возвращает значение TRUE , если указанный указатель не имеет значения NULL. В версиях библиотекИ CRT до Visual Studio 2010 возвращается TRUE , допустим ли диапазон памяти для указанной операции или операций. В противном случае функция возвращает значение FALSE.

Замечания

В библиотеке CRT в Visual Studio 2010 и более поздних версиях size access параметры игнорируются и _CrtIsValidPointer проверяются только то, что указанный параметр address не имеет значения NULL. Так как этот тест легко выполнять самостоятельно, мы не рекомендуем использовать эту функцию. В версиях, выпущенных до выхода Visual Studio 2010, эта функция проверяет допустимость диапазона памяти, начинающегося по адресу address и занимающего заданное параметром size количество байт, для указанной операции или операций доступа. Если access задано значение TRUE, диапазон памяти проверяется как для чтения, так и для записи. Если access это FALSEтак, диапазон памяти проверяется только для чтения. Если _DEBUG это не определено, вызовы _CrtIsValidPointer удаляются во время предварительной обработки.

Так как эта функция возвращает TRUE или FALSEпередается одному из _ASSERT макросов, чтобы создать базовый механизм обработки ошибок отладки. В следующем примере возникает сбой утверждения, если диапазон памяти недействителен как для операций чтения, так и для записи:

_ASSERTE( _CrtIsValidPointer( address, size, TRUE ) );

Дополнительные сведения о том, как _CrtIsValidPointer можно использовать с другими функциями отладки и макросами, см. в разделе "Макросы" для создания отчетов. Сведения о выделении, инициализации и управлении блоками памяти в отладочной версии базовой кучи см. в сведениях об отладочной куче CRT.

Требования

Маршрут	Обязательный заголовок
_CrtIsValidPointer	<crtdbg.h>

_CrtIsValidPointer является расширением Майкрософт. Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Только отладочные версии библиотек времени выполнения языка C.

Пример

См. пример статьи _CrtIsValidHeapPointer .

См. также

Отладка подпрограмм