當(dāng)調(diào)用一個(gè)Windows函數(shù)時(shí)，它首先要檢驗(yàn)傳遞給它的各個(gè)參數(shù)的有效性，然后再設(shè)法執(zhí)行任務(wù).如果傳遞一個(gè)無效參數(shù)，或者由于某種原因無法執(zhí)行這項(xiàng)操作，那么操作系統(tǒng)就會(huì)返回一個(gè)值，指明該函數(shù)在某種程度上運(yùn)行失敗了。
Windows函數(shù)常用的返回值類型:
void
BOOL:0,非0,TURE,FALSE
HANDLE:HANDLE,NULL,INVALID_HANDLE_VALID)
PVOID:NULL,PVOID
LONG/DWORD:具體函數(shù)而定
...
Microsoft編譯了一個(gè)所有可能的錯(cuò)誤代碼列表，并且為每個(gè)錯(cuò)誤代碼分配了一個(gè)32位的號(hào)碼. WinError.h頭文件(大約2萬多行)包含了Micorsoft定義的錯(cuò)誤代碼列表.
當(dāng)一個(gè)Windows函數(shù)檢測到一個(gè)錯(cuò)誤時(shí)，它會(huì)使用線程本地存儲(chǔ)(thread-local storage)機(jī)制，將相應(yīng)的錯(cuò)誤代碼號(hào)碼與調(diào)用的線程關(guān)聯(lián)起來.這將使線程能夠互相獨(dú)立的運(yùn)行,而不會(huì)影響各自的錯(cuò)誤代碼.
當(dāng)函數(shù)返回時(shí)，它的返回值就能指明是否有錯(cuò)誤發(fā)生，若有且要確定是什么錯(cuò)誤,就需要調(diào)用DWORD GetLastError()函數(shù),它返回線程的32位錯(cuò)誤代碼.Visual Studio有一個(gè)Error Lookup程序可用將錯(cuò)誤代碼的號(hào)碼換成相應(yīng)文本描述.Windows還提供了一個(gè)函數(shù)FormatMessage可以將錯(cuò)誤代碼轉(zhuǎn)換成它的文本描述.
DWORD FormatMessage(
DWORD dwFlags, // source and processing options
LPCVOID lpSource, // message source
DWORD dwMessageId, // message identifier
DWORD dwLanguageId, // language identifier
LPTSTR lpBuffer, // message buffer
DWORD nSize, // maximum size of message buffer
va_list *Arguments // array of message inserts
);
我們也可以在自己的函數(shù)中使用該機(jī)制,只需要使用VOID SetLastError(DWORD dwErrCode)函數(shù)即可,如果WinError.h中的任何代碼都不能正確地反映該錯(cuò)誤的性質(zhì)，那么可以創(chuàng)建你自己的代碼。錯(cuò)誤代碼的域的劃分表:
位 31~30 29 28 27~16 15~0
內(nèi)容 嚴(yán)重性 Microsoft/客戶 保留 設(shè)備代碼 異常代碼
含義 0=成功 0=MS定義的代碼 必順是0 由MS定義 由MS或客戶定義
1=參考
2=警告 1=客戶定義的代碼
3=錯(cuò)誤
注:如果創(chuàng)建自己的錯(cuò)誤代碼，必順使29位為1.