Compartir a través de


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

Vea también

Funciones de control de errores

Obtener último error

Último código de error

SetLastErrorEx

API de Vertdll disponibles en enclaves de VBS