Función SetLastError (errhandlingapi.h)
Establece el último código de error para el subproceso que realiza la llamada.
Sintaxis
void SetLastError(
[in] DWORD dwErrCode
);
Parámetros
[in] dwErrCode
El último código de error del subproceso.
Valor devuelto
None
Observaciones
El último código de error se mantiene en el almacenamiento local del subproceso para que varios subprocesos no sobrescriban los valores de los demás.
La mayoría de las funciones llaman a SetLastError o SetLastErrorEx solo cuando se produce un error. Sin embargo, algunas funciones del sistema llaman a SetLastError o SetLastErrorEx en condiciones de éxito; esos casos se indican en la documentación de cada función.
Opcionalmente, las aplicaciones pueden recuperar el valor establecido por esta función mediante la función GetLastError inmediatamente después de que se produzca un error en una función.
Los códigos de error son valores de 32 bits (el bit 31 es el más significativo). El bit 29 está reservado para códigos de error definidos por la aplicación; ningún código de error del sistema tiene este bit establecido. Si va a definir un código de error para la aplicación, establezca este bit para indicar que la aplicación ha definido el código de error y para asegurarse de que el código de error no entra en conflicto con ningún código de error definido por el sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | errhandlingapi.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |