VC8/9中CRT函数对非法参数的处理

在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: %dn", function, file, line);
　　 wprintf(L"Expression: %sn", 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:ddvctoolscrt_bldself_x86crtsrcprintf.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报告越界，这就隐藏了抛出的异常（当然，如果你在弹出的断言失败对话框中选择“忽略”后，还是能够捕获到异常的）。