Compartilhar via


Usando macros para tratamento de erros

Aplica-se a: Outlook 2013 | Outlook 2016

Há várias macros para facilitar o trabalho com valores HRESULT.

Há dois conjuntos de macros que testam para falha ou êxito: HR_SUCCEEDED e HR_FAILED e SUCCEEDED e FAILED. SUCCEEDED é o mesmo que HR_SUCCEEDED e FAILED é o mesmo que HR_FAILED.

Nesse caso, use a macro ResultFromScode para definir a variável HRESULT como o valor HRESULT correspondente para S_OK.

As macros comumente usadas são descritas brevemente na tabela a seguir.

Macro Descrição
MAKE_HRESULT
Constrói um HRESULT a partir de seus componentes.
HR_SUCCEEDED
Testa um HRESULT para obter um êxito ou uma condição de aviso.
HR_FAILED
Testa um HRESULT para obter uma condição de erro.
HRESULT_CODE
Extrai a parte do código de erro do HRESULT.
HRESULT_FACILITY
Extrai a instalação do HRESULT.
HRESULT_SEVERITY
Extrai o bit de gravidade da SEVERITY.
CONSEGUIU
Testa um HRESULT para obter um êxito ou uma condição de aviso.
FALHOU
Testa um HRESULT para obter uma condição de erro.