EN
Este contenido no se encuentra disponible en su idioma, pero aquí tiene la versión en inglés.

SetLastError function

Sets the last-error code for the calling thread.

Syntax


void WINAPI SetLastError(
  _In_  DWORD dwErrCode
);

Parameters

dwErrCode [in]

The last-error code for the thread.

Return value

This function does not return a value.

Remarks

The last-error code is kept in thread local storage so that multiple threads do not overwrite each other's values.

Most functions call SetLastError or SetLastErrorEx only when they fail. However, some system functions call SetLastError or SetLastErrorEx under conditions of success; those cases are noted in each function's documentation.

Applications can optionally retrieve the value set by this function by using the GetLastError function immediately after a function fails.

Error codes are 32-bit values (bit 31 is the most significant bit). Bit 29 is reserved for application-defined error codes; no system error code has this bit set. If you are defining an error code for your application, set this bit to indicate that the error code has been defined by your application and to ensure that your error code does not conflict with any system-defined error codes.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Error Handling Functions
GetLastError
Last-Error Code
SetLastErrorEx

 

 

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft