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

comm_status

fault_status

Arquivo IDL (Definição de Interface)

Longas

out

Typedef

Unsigned