Tratamento de erros em COM (COM)
Quase todas as funções COM e métodos de interface retornam um valor do tipo HRESULT. O HRESULT (o nome pode ser lido como "identificador de resultado") é uma maneira de retornar um valor de êxito, aviso ou erro. Um HRESULT não é realmente um identificador (consulte Por que HRESULT começa com H quando não é um identificador para nada?); é apenas um valor com vários campos codificados nele. De acordo com a especificação COM, um resultado de zero indica êxito e um resultado diferente de zero indica falha.
No nível do código-fonte, todos os valores de erro consistem em três partes, separadas por sublinhados. A primeira parte é o prefixo que identifica a instalação associada ao erro, a segunda parte é E para erro e a terceira parte é uma cadeia de caracteres que descreve a condição real. Por exemplo, STG_E_MEDIUMFULL é retornado quando não há espaço em um disco rígido. O prefixo STG indica o recurso de armazenamento, o E indica que o código de status representa um erro e o MEDIUMFULL fornece informações específicas sobre o erro. Muitos dos valores que talvez você queira retornar de um método ou função de interface são definidos em Winerror.h.
Para obter mais informações sobre o tratamento de erros, consulte as seguintes seções:
- estrutura de códigos de erro COM
- códigos no FACILITY_ITF
- usando macros para tratamento de erros
- tratamento de erros COM no Java e no Visual Basic
- estratégias de tratamento de erros
- tratando erros desconhecidos
Tópicos relacionados