CeGetLastError (RAPI)
.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 method returns the calling thread's last-error code value related to RAPI function calls.
Syntax
DWORD CeGetLastError( 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 CeGetLastError 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 Microsoft 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.
CeGetLastError não é considerado thread-safe. Se o seu aplicativo cria múltiplo segmentos cliente, todos eles fazer chamadas RAPI usando o mesmo objeto sessão. Since the last-error code value is shared globally, a failed RAPI call can overwrite the last-error code value written by a RAPI call on another thread. Isso significa que o valor recuperado pelo CeGetLastError Talvez não seja um você desejar, pois ele pode ser associado com um chamar RAPI em outro segmento.
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 o arquivo de cabeçalho SDK WINERROR.H ou valores de erro.
Requirements
| Header | rapi.h |
| Library | rapi.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2000 and later, Smartphone 2002 and later |