%>
设置在 CRT 检测到无效自变量时要调用的函数。
语法
_invalid_parameter_handler _set_invalid_parameter_handler(
_invalid_parameter_handler pNew
);
_invalid_parameter_handler _set_thread_local_invalid_parameter_handler(
_invalid_parameter_handler pNew
);
参数
pNew
指向新的无效参数处理程序的函数指针。
返回值
指向调用前的无效参数处理程序的指针。
注解
许多 C 运行时函数检查已传递给它们的参数的有效性。 如果传递了无效参数，则此函数可设置 errno 错误号或返回错误代码。 在此类情况下，还将调用无效参数处理程序。 C 运行时提供默认的全局无效参数处理程序，该处理程序将终止程序，并显示运行时错误消息。 可以使用 _set_invalid_parameter_handler 将自己的函数设置为全局无效参数处理程序。 C 运行时还支持一个线程本地无效参数处理程序。 如果通过使用 _set_thread_local_invalid_parameter_handler 在线程中设置了线程本地参数处理程序，则从线程调用的 C 运行时函数使用该处理程序而不使用全局处理程序。 一次只能将一个函数指定为全局无效实参处理程序。 只能将每个线程的一个函数指定为线程本地无效实参处理程序，但不同的线程可以具有不同的线程本地处理程序。 通过线程本地处理程序，你可更改在代码的一部分中使用的处理程序，而不影响其他线程的行为。
当运行时调用无效参数函数时，通常表示发生了不可恢复的错误。 你提供的无效参数处理程序函数应保存自身能够保存的所有数据，然后中止。 它不应将控件返回到主函数，除非你确信此错误是可恢复的。
无效参数处理程序函数必须具有以下原型：
void _invalid_parameter(
const wchar_t * expression,
const wchar_t * function,
const wchar_t * file,
unsigned int line,
uintptr_t pReserved
);
expression 自变量是引发错误的自变量表达式的宽字符串表示形式。 function 自变量是已接收无效自变量的 CRT 函数的名称。 file 自变量是包含该函数的 CRT 源文件的名称。 line 自变量是该文件的行号。 最后一个自变量是保留的。 所有参数都具有值 NULL，除非使用 CRT 库的调试版本。
默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。
要求
| 例程 | 必需的标头 |
|---|---|
| %> | C：<stdlib.h> C++：<cstdlib> 或 <stdlib.h> |
_set_invalid_parameter_handler 和 _set_thread_local_invalid_parameter_handler 函数是 Microsoft 特定函数。 有关兼容性信息，请参阅兼容性。
示例
在下面的示例中，将使用无效参数错误处理程序来打印已接收无效参数和 CRT 源中的文件和行的函数。 当使用调试 CRT 库时，无效参数错误也将引发断言，此示例中已使用 _CrtSetReportMode 禁用断言。
// 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);
abort();
}
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);
}
Invalid parameter detected in function common_vfprintf. File: minkernel\crts\ucrt\src\appcrt\stdio\output.cpp Line: 32
Expression: format != nullptr