Compartilhar via


Usando macros para tratamento de erros

COM define um número de macros que facilitam o trabalho com valores HRESULT .

As macros de tratamento de erros são descritas na tabela a seguir.

Macro Descrição
MAKE_HRESULT
Retorna um HRESULT dado o bit de gravidade, o código de recurso e o código de erro que compõem o HRESULT.
Observação: chamar MAKE_HRESULT para verificação de S_OK acarreta uma penalidade de desempenho. Você não deve usar rotineiramente MAKE_HRESULT para obter resultados bem-sucedidos.
MAKE_SCODE
Retorna um SCODE dado o bit de gravidade, o código de recurso e o código de erro que compõem o SCODE.
HRESULT_CODE
Extrai a parte do código de erro do HRESULT.
HRESULT_FACILITY
Extrai o código de recurso do HRESULT.
HRESULT_SEVERITY
Extrai o bit de gravidade do HRESULT.
SCODE_CODE
Extrai a parte do código de erro do SCODE.
SCODE_FACILITY
Extrai o código de recurso do SCODE.
SCODE_SEVERITY
Extrai o campo de gravidade do SCODE.
SUCCEEDED
Testa o bit de severidade do SCODE ou HRESULT, retorna TRUE se a gravidade for zero e FALSE se for um.
FAILED
Testa o bit de gravidade do SCODE ou HRESULT, retorna TRUE se a gravidade for um e FALSE se for zero.
IS_ERROR
Fornece um teste genérico para erros em qualquer valor de status.
HRESULT_FROM_WIN32
Mapeia um código de erro do sistema para um valor HRESULT.
HRESULT_FROM_NT
Mapeia um valor de status NT para um valor HRESULT .

Tratamento de erro em COM