Funzione SetLastError (errhandlingapi.h)

Imposta l'ultimo codice di errore per il thread chiamante.

Sintassi

void SetLastError(
  [in] DWORD dwErrCode
);

Parametri

[in] dwErrCode

Codice di ultimo errore per il thread.

Valore restituito

nessuno

Osservazioni

L'ultimo codice di errore viene mantenuto nell'archiviazione locale del thread in modo che più thread non sovrascrivono i valori dell'altro.

La maggior parte delle funzioni chiama SetLastError o SetLastErrorEx solo quando ha esito negativo. Tuttavia, alcune funzioni di sistema chiamano SetLastError o SetLastErrorEx in condizioni di esito positivo; tali casi sono indicati nella documentazione di ogni funzione.

Le applicazioni possono facoltativamente recuperare il valore impostato da questa funzione usando la funzione GetLastError immediatamente dopo un errore di una funzione.

I codici di errore sono valori a 32 bit (bit 31 è il bit più significativo). Bit 29 è riservato ai codici di errore definiti dall'applicazione; nessun codice di errore di sistema ha questo bit impostato. Se si definisce un codice di errore per l'applicazione, impostare questo bit per indicare che il codice di errore è stato definito dall'applicazione e per assicurarsi che il codice di errore non sia in conflitto con i codici di errore definiti dal sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	errhandlingapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni di gestione degli errori

Getlasterror

Codice ultimo errore

SetLastErrorEx

API Vertdll disponibili nelle enclave VBS