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 |