C語言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

#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函數對非法參數的ASSERT報告。事實上，CRT庫中其它一些特性的開啟與關閉在Debug版下都需要關閉ASSERT報告才能夠體現。例如，如果要使Checked Iterator越界發生時拋出異常，則可以定義宏_SECURE_SCL_THROWS的值為1。然而，如果Debug版不關閉ASSERT，則會在拋出異常之前CRT先使用ASSERT報告越界，這就隱藏了拋出的異常(當然，如果你在彈出的斷言失敗對話框中選擇“忽略”后，還是能夠捕獲到異常的)。

深圳北大青鳥http://www.sbsnmc.com