SetLastError
.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
Essa função define o último-código de erro para o segmento chamado.
Syntax
void SetLastError(
DWORD dwErrCode
);
Parameters
- dwErrCode
[no] Especifica a última-código de erro para o segmento.
Return Value
Nenhum.
Remarks
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 para indicar que a código de erro foi definido por seu aplicativo e para garantir que seu código de erro não estar em conflito com com todos os códigos de erro System-defined.
Essa função destina-se principalmente de dinâmico-link DLLs (bibliotecas). Chamar esta função depois que ocorrer um erro permite a DLL emular o comportamento de uma função Win32.
A maioria dos chamar funções Win32 SetLastError Quando eles falham. 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.
Os aplicativos podem recuperar o valor salvo por essa função usando o GetLastError função. O uso de GetLastError é opcional; Um aplicativo pode chamá-lo para localizar sem o motivo específico para uma função falha.
A última-código de erro é mantido no segmento local armazenamento assim que múltiplo segmentos não substituir valores uns dos outros.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |