在VC8/9中,許多CRT函數(shù)會檢查傳入的參數(shù)的合法性。當CRT函數(shù)檢測到一個非法參數(shù)傳入時,它會調用“非法參數(shù)處理 例程”。默認的非法參數(shù)處理例程是調用Watson Crash Reporting,讓應用程序崩潰,并詢問用戶是否愿意發(fā)送崩潰數(shù)據(jù)轉儲給Microsoft分析。在Debug模式下,非法參數(shù)還會產生失敗的斷言。
可以通過調用_set_invalid_parameter_handler來設置自定義處理例程,來代替默認的處理例程。如果你指定的處理例程沒有終止程序,那么在該處理例程返回后,該CTR函數(shù)將重新獲得控制權。此時,這些CTR函數(shù)通常停止執(zhí)行,并返回一個錯誤代碼,并設置errno。多數(shù)情況下,errno值和返回值都是EINVAL,指示一個非法參數(shù)。某些情況下,會返回一個更詳細的錯誤代碼。
_set_invalid_parameter_handler函數(shù)原型如下:
_invalid_parameter_handler _set_invalid_parameter_handler(
_invalid_parameter_handler pNew
);
它使用參數(shù)pNew指定的處理例程代替現(xiàn)有處理例程,并返回被代替的處理例程。
非法參數(shù)處理例程類型_invalid_parameter_handler的函數(shù)原型如下:
void _invalid_parameter(
const wchar_t * expression,
const wchar_t * function,
const wchar_t * file,
unsigned int line,
uintptr_t pReserved
);
其中,第一個參數(shù)是參數(shù)表達式,第二個參數(shù)是發(fā)現(xiàn)非法參數(shù)的CRT函數(shù)名,第三個參數(shù)是CRT源代碼的文件名,第四個參數(shù)是代碼行,最后一個參數(shù)為保留值。如果使用非Debug版CRT庫,則所有這些參數(shù)值都為NULL。
引用MSDN上的例子如下:
// crt_set_invalid_parameter_handler.c
// compile with: /Zi /MTd
#include
#include
#include // 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函數(shù)對非法參數(shù)的ASSERT報告。事實上,CRT庫中其它一些特性的開啟與關閉在Debug版下都需要關閉ASSERT報告才能夠體現(xiàn)。例如,如果要使Checked Iterator越界發(fā)生時拋出異常,則可以定義宏_SECURE_SCL_THROWS的值為1。然而,如果Debug版不關閉ASSERT,則會在拋出異常之前CRT先使用ASSERT報告越界,這就隱藏了拋出的異常(當然,如果你在彈出的斷言失敗對話框中選擇“忽略”后,還是能夠捕獲到異常的)。
深圳北大青鳥http://www.sbsnmc.com