SetLastError

Składnia

Argumenty

Argument	Opis
dwErrCode	Ostatni kod błędu dla wątku.

Opis szczegółowy

Funkcja SetLastError 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 SetLastError oraz _{» WinAPI ♦} 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.

Wymagania

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

Zagadnienia powiązane

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

Linki zewnętrzne

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