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

最新推荐文章于 2025-11-24 17:30:40 发布

转载最新推荐文章于 2025-11-24 17:30:40 发布 · 751 阅读

文章标签：

#function #microsoft #file #iterator #null #crash

本文介绍VC8/9环境下如何通过_set_invalid_parameter_handler自定义非法参数处理例程，替代默认处理行为，实现更灵活的应用程序错误管理。

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