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

来源:网络时间:2011-06-24

  在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报告越界,这就隐藏了抛出的异常(当然,如果你在弹出的断言失败对话框中选择“忽略”后,还是能够捕获到异常的)。

发表评论

最新评论(共0条)