atributo error_status_t
O error_status_t palavra-chave designa um tipo para um objeto que contém informações de status de comunicação ou status de falha.
[ [ , ACF-function-attributes ] ] error_status_t function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ...);
[ [ ACF-function-attributes ] ] function-name(
[ [ ACF-parameter-attributes ] ] error_status_t parameter-name
, ...);
Parâmetros
-
ACF-function-attributes
-
Especifica zero ou mais atributos de função ACF, como [comm_status], [fault_status]ou [nocode]. Os atributos de função são colocados entre colchetes. Zero ou mais atributos podem ser aplicados a uma função. Separe vários atributos de função com vírgulas.
-
nome da função
-
Especifica o nome da função conforme definido no arquivo IDL.
-
ACF-parameter-attributes
-
Especifica atributos que se aplicam a um parâmetro . Observe que zero, um ou mais atributos podem ser aplicados ao parâmetro . Separe vários atributos de parâmetro com vírgulas. Os atributos de parâmetro são colocados entre colchetes. Atributos de parâmetro IDL, como atributos direcionais, não são permitidos no ACF.
-
parameter-name
-
Especifica o parâmetro para a função conforme definido no arquivo IDL. Cada parâmetro para a função deve ser especificado na mesma sequência, usando o mesmo nome definido no arquivo IDL.
Comentários
O tipo error_status_t é usado como parte da arquitetura de tratamento de exceção no IDL. Esse tipo é mapeado para um longosem sinal. Os aplicativos que capturam situações de erro têm um parâmetro [out] ou um tipo de retorno de um procedimento especificado como error_status_t e qualificam o error_status_t com os atributos [comm_status] ou [fault_status] no ACF. Se o parâmetro ou o tipo de retorno não tiver sido qualificado com os atributos [comm_status] ou [fault_status] , o parâmetro funcionará como se fosse um longo sem sinal.
A partir da versão 2.0, o compilador MIDL gera stubs que contêm a arquitetura adequada de tratamento de erros. No entanto, versões anteriores do compilador MIDL manipulavam um parâmetro ou tipo de retorno de error_status_t como se os atributos [comm_status] e [fault_status] fossem aplicados, mesmo que não fossem. Com MIDL 2.0 ou posterior, você deve aplicar explicitamente os atributos [comm_status] e [fault_status] ao parâmetro ou procedimento no ACF.
O tipo error_status_t é um dos tipos predefinidos da linguagem de definição de interface. Tipos predefinidos podem aparecer como especificadores de tipo em declarações typedef , em declarações gerais e em declaradores de função (como o tipo de retorno de função ou como especificadores de tipo de parâmetro).
Confira também