SetLastErrorEx

Składnia

Argumenty

Argument	Opis
dwErrCode	Ostatni kod błędu dla wątku.
dwType	Ten argument jest ignorowany.

Opis szczegółowy

Funkcja SetLastErrorEx ustawia kod błędu dla danego wątku. Jest on przechowywany w lokalnej pamięci każdego z wątków, więc nie ma możliwości nadpisania tej wartości przez inny wątek.

Większość funkcji wywołuje _{» WinAPI ♦} SetLastError oraz SetLastErrorEx tylko w przypadku błędu. Niektóre jednak wywołują je w celu zasygnalizowania sukcesu. Te przypadki są opisane w dokumentacji.

Aby uzyskać kod błędu ustawiony przez tą funkcję, aplikacje mogą wywoływać _{» WinAPI ♦} GetLastError bezpośrednio po funkcji, której wywołanie się nie udało.

Kody błędu są wartościami 32-bitowymi (bit 31 jest najbardziej znaczącym bitem). Bit 29 jest zarezerwowany dla kodów błędów aplikacji, żaden z kodów systemowych nie posiada tego bitu ustawionego. Jeśli tworzysz własne kody błędów, ustaw ten bit aby wskazać, że kod ten został ustanowiony przez Twoją aplikację, oraz aby zagwarantować, że kod ten nie będzie kolidował z żadnym z systemowych kodów błędów.

Aktualnie, działanie funkcji SetLastErrorEx jest identyczne jak działanie _{» WinAPI ♦} SetLastError.

Wymagania

Minimalny obsługiwany klient	Windows XP
Minimalny obsługiwany serwer	Windows Server 2003
Plik nagłówkowy	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll

Zagadnienia powiązane

GetLastError	Zwraca ostatni kod błędu, który wystąpił na wątku wywołującym niniejszą funkcję. (funkcja)
SetLastError	Ustawia kod błędu dla danego wątku. (funkcja)

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms680629(v=vs.85).aspx