GetLastError
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
This function returns the calling thread's last-error code value. Um remoto aplicativo versão interface (RAPI) dessa função existe e é nomeado CeGetLastError (RAPI).
Syntax
DWORD GetLastError(void);
Parameters
Nenhum.
Return Value
The calling thread's last-error code value indicates success. Funções definir esse valor chamado de SetLastError função. O Return valor seção de cada página de referência anotações as condições sob as quais a função define o último-código de erro.
Remarks
Você deve chamar o GetLastError função imediatamente quando valor de retorno de uma função indica que tal uma chamar irá retornar dados úteis. Isso ocorre porque alguns chamar funções SetLastError(0) quando eles êxito, remover fora de código de erro definido pelo mais recentemente falha função.
Most functions in the Win32 API that set the thread's last error code value set it when they fail; a few functions set it when they succeed. Função falha é geralmente indicado por um código de erro valor de retorno such as FALSE, NULL, 0xFFFFFFFF, ou – 1. Alguns chamar funções SetLastError Sob condições de sucesso; Esses casos são indicados na página de referência de cada função.
Códigos de erro são 32-valores bit (bit 31 é o bit mais significativo). Bit 29 é reservado para códigos de erro definido pelo aplicativo; Nenhuma código de erro sistema definiu esse bit. Se você estiver definindo um código de erro para seu aplicativo, defina esse bit como um. Que indica que a código de erro foi definido por um aplicativo e garante que o código de erro não estar em conflito com com todos os códigos de erro definidos pelo sistema.
Para obter um seqüência de caracteres de erro de sistema códigos de erro, use o FormatMessage função. Para um lista completa de códigos de erro, consulte Valores de erro ou o arquivo de cabeçalho SDK WINERROR.H.
Requirements
| Header | winbase.h |
| Library | coredll.lib, Nk.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |