|
當調用一個Windows函數時，它首先要檢驗傳遞給它的各個參數的有效性，然后再設法執行任務.如果傳遞一個無效參數，或者由于某種原因無法執行這項操作，那么操作系統就會返回一個值，指明該函數在某種程度上運行失敗了。
Windows函數常用的返回值類型:
void
BOOL:0,非0,TURE,FALSE
HANDLE:HANDLE,NULL,INVALID_HANDLE_VALID)
PVOID:NULL,PVOID
LONG/DWORD:具體函數而定
...
Microsoft編譯了一個所有可能的錯誤代碼列表，并且為每個錯誤代碼分配了一個32位的號碼. WinError.h頭文件(大約2萬多行)包含了Micorsoft定義的錯誤代碼列表.
當一個Windows函數檢測到一個錯誤時，它會使用線程本地存儲(thread-local storage)機制，將相應的錯誤代碼號碼與調用的線程關聯起來.這將使線程能夠互相獨立的運行,而不會影響各自的錯誤代碼.
當函數返回時，它的返回值就能指明是否有錯誤發生，若有且要確定是什么錯誤,就需要調用DWORD GetLastError()函數,它返回線程的32位錯誤代碼.Visual Studio有一個Error Lookup程序可用將錯誤代碼的號碼換成相應文本描述.Windows還提供了一個函數FormatMessage可以將錯誤代碼轉換成它的文本描述.
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
);
我們也可以在自己的函數中使用該機制,只需要使用VOID SetLastError(DWORD dwErrCode)函數即可,如果WinError.h中的任何代碼都不能正確地反映該錯誤的性質，那么可以創建你自己的代碼。錯誤代碼的域的劃分表:
位 31~30 29 28 27~16 15~0
內容 嚴重性 Microsoft/客戶 保留 設備代碼 異常代碼
含義 0=成功 0=MS定義的代碼 必順是0 由MS定義 由MS或客戶定義
1=參考
2=警告 1=客戶定義的代碼
3=錯誤
注:如果創建自己的錯誤代碼，必順使29位為1.
|
