`_RTC_SetErrorFuncW`

Статья
04/03/2023

Назначает функцию в качестве обработчика для сообщений о проверке на ошибки во время выполнения (RTC).

Синтаксис

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Параметры

function
Адрес функции, которая будет обрабатывать проверки на ошибки во время выполнения.

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

Ранее определенная функция ошибки; или NULL если ранее не определена функция.

Замечания

В новом коде используйте только _RTC_SetErrorFuncW. _RTC_SetErrorFunc включена в библиотеку только для обеспечения обратной совместимости.

Обратный вызов _RTC_SetErrorFuncW применяется только к компоненту, с которым он был связан, но не глобально.

Убедитесь, что передаваемый в _RTC_SetErrorFuncW адрес относится к допустимой функции обработки ошибок.

Если ошибка была назначена типом -1 с помощью _RTC_SetErrorType, функция обработки ошибок не вызывается.

Перед тем, как вы сможете вызвать эту функцию, необходимо сначала вызвать одну из функций инициализации проверки на ошибки во время выполнения. Дополнительные сведения см. в разделе "Использование проверок среды выполнения без библиотеки среды выполнения C".

_RTC_error_fnW определяется следующим образом:

typedef int (__cdecl * _RTC_error_fnW)(
    int errorType,
    const wchar_t * filename,
    int linenumber,
    const wchar_t * moduleName,
    const wchar_t * format,
    ... );

где:

errorType
Тип ошибки, указанной в _RTC_SetErrorTypeпараметре .

filename
Исходный файл, где произошел сбой, или значение NULL, если информация об отладке недоступна.

linenumber
Строка, в filename которой произошел сбой, или 0, если нет сведений об отладке.

moduleName
Библиотека DLL или имя исполняемого файла, где произошел сбой.

format
Строка в стиле printf для отображения сообщения об ошибке с использованием оставшихся параметров. Первым аргументом VA_ARGLIST является номер ошибки RTC, который произошел.

Пример использования _RTC_error_fnWсм. в разделе "Проверка собственной среды выполнения".

Требования

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

Дополнительные сведения см. в разделе Совместимость.

Библиотеки

Все версии библиотек времени выполнения языка C.

См. также

_CrtDbgReport, _CrtDbgReportW
Проверка ошибок во время выполнения

Поделиться через