HRESULT
.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 hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
The HRESULT tipo de dados é um 32 - bit valor é usado para descrever um erro ou aviso.
Observação
A maioria dos métodos MAPI e funções retornam HRESULT Valores para fornecer informações detalhadas resultado.HRESULT Valores também são usados amplamente nos métodos interface COM.
Syntax
ULONG HRESULT;
Remarks
O valor de retorno de COM funções e métodos é um HRESULT, que não é um identificador para um objeto, mas é um 32 - bit valor com vários campos codificados em um único 32 - bit variável ULONG.
O seguinte definir representa um HRESULT valor.
.gif)
A seguinte tabela mostra como decodificar as informações contidas em um HRESULT.
| Seção | Description | Tamanho em bits | Interpretação |
|---|---|---|---|
S |
Codificar a gravidade |
1 |
Indica o sucesso ou falha. 0 - Sucesso (SEVERITY_SUCCESS). |
R |
Um bit reservado |
1 |
Ignore. |
C |
Um bit reservado |
1 |
Ignore. |
N |
Um bit reservado |
1 |
Ignore. |
r |
Um bit reservado |
1 |
Ignore. |
Instalações |
A codificar instalações |
11 |
Especifica o componente software que define este código de erro. De exemplo, FACILITY_RPC. |
O código |
Codificar status das instalações |
16 |
Um codificar descrevendo o erro ou aviso. De exemplo, E_UNEXPECTED. Consulte Erros do sistema - numérico pedido Para uma listagem dos valores de erro sistema possível. |
Definições de Códigos aviso e erro estão contidas na Winerror.h header file.
Em 32-bit plataformas, o SCODE tipo de dados é igual a HRESULT tipo de dados.
Para obter mais informações sobre erro e aviso códigos, consulte Valores de erroe o Structure emMSDN.