在VC8/9中,许多CRT函数会检查传入的参数的合法性。当CRT函数检测到一个非法参数传入时,它会调用“非法参数处理 例程”。默认的非法参数处理例程是调用Watson Crash Reporting,让应用程序崩溃,并询问用户是否愿意发送崩溃数据转储给Microsoft分析。在Debug模式下,非法参数还会产生失败的断言。
可以通过调用_set_invalid_parameter_handler来设置自定义处理例程,来代替默认的处理例程。如果你指定的处理例程没有终止程序,那么在该处理例程返回后,该CTR函数将重新获得控制权。此时,这些CTR函数通常停止执行,并返回一个错误代码,并设置errno。多数情况下,errno值和返回值都是EINVAL,指示一个非法参数。某些情况下,会返回一个更详细的错误代码。
_set_invalid_parameter_handler函数原型如下:
_invalid_parameter_handler _set_invalid_parameter_handler(
_invalid_parameter_handler pNew
);
它使用参数pNew指定的处理例程代替现有处理例程,并返回被代替的处理例程。
非法参数处理例程类型_invalid_parameter_handler的函数原型如下:
void _invalid_parameter(
const wchar_t * expression,
const wchar_t * function,
const wchar_t * file,
unsigned int line,
uintptr_t pReserved
);
其中,第一个参数是参数表达式,第二个参数是发现非法参数的CRT函数名,第三个参数是CRT源代码的文件名,第四个参数是代码行,最后一个参数为保留值。如果使用非Debug版CRT库,则所有这些参数值都为NULL。
引用MSDN上的例子如下:
// crt_set_invalid_parameter_handler.c
// compile with: /Zi /MTd
#include <stdio.h>
#include <stdlib.h>
#include <crtdbg.h> // For _CrtSetReportMode
void myInvalidParameterHandler(const wchar_t* expression,
const wchar_t* function,
const wchar_t* file,
unsigned int line,
uintptr_t pReserved)
{
wprintf(L"Invalid parameter detected in function %s."
L" File: %s Line: %d\n", function, file, line);
wprintf(L"Expression: %s\n", expression);
}
int main( )
{
char* formatString;
_invalid_parameter_handler oldHandler, newHandler;
newHandler = myInvalidParameterHandler;
oldHandler = _set_invalid_parameter_handler(newHandler);
// Disable the message box for assertions.
_CrtSetReportMode(_CRT_ASSERT, 0);
// Call printf_s with invalid parameters.
formatString = NULL;
printf(formatString);
}
运行结果(VC9 SP1):
Invalid parameter detected in function printf. File: f:\dd\vctools\crt_bld\self_x86\crt\src\printf.c Line: 54Expression: (format != NULL)
关于此例子的一点说明:例子中调用了_CrtSetReportMode(_CRT_ASSERT, 0)来关闭Debug版CRT函数对非法参数的ASSERT报告。事实上,CRT库中其它一些特性的开启与关闭在Debug版下都需要关闭ASSERT报告才能够体现。例如,如果要使Checked Iterator越界发生时抛出异常,则可以定义宏_SECURE_SCL_THROWS的值为1。然而,如果Debug版不关闭ASSERT,则会在抛出异常之前CRT先使用ASSERT报告越界,这就隐藏了抛出的异常(当然,如果你在弹出的断言失败对话框中选择“忽略”后,还是能够捕获到异常的)。