atributo fault_status

O atributo ACF [fault_status] especifica que um código de erro do tipo error_status_t indica uma falha do procedimento remoto, em vez de outros tipos de problemas, como erros de comunicação.

[fault_status [ , ACF-function-attributes ] ] function-name(
    [ [ ACF-parameter-attributes ] ] parameter-name
    , ... );

[ [ ACF-function-attributes ] ] function-name(
    [fault_status [ , ACF-parameter-attributes ] ] parameter-name
    , ... );

Parâmetros

ACF-function-attributes

Especifica zero ou mais atributos de função ACF, como [fault_status] e [nocode]. Os atributos de função são colocados entre colchetes. Observe que zero ou mais atributos podem ser aplicados a uma função. Separe vários atributos de função com vírgulas. Observe também que, se [fault_status] aparecer como um atributo de função, ele também não poderá aparecer como um atributo de parâmetro.

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 ou mais atributos podem ser aplicados ao parâmetro . Os atributos de parâmetro são colocados entre colchetes. Separe vários atributos de parâmetro com vírgulas. Atributos de parâmetro IDL, como atributos direcionais, não são permitidos no ACF. Observe que, se [fault_status] aparecer como um atributo de parâmetro, ele também não poderá aparecer como um atributo de função.

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 atributo [fault_status] pode ser usado como um atributo de função ou como um atributo de parâmetro, mas pode aparecer apenas uma vez por função. Ele pode ser aplicado à própria função ou a um parâmetro em cada função.

O atributo [fault_status] só pode ser aplicado a funções que retornam o tipo error_status_t. Quando o procedimento remoto falha de uma forma que faz com que uma PDU de falha seja retornada, um código de erro é retornado.

Quando [fault_status] é usado como um atributo de parâmetro, o parâmetro deve ser um parâmetro [out] do tipo error_status_t. Se ocorrer um erro de servidor, o parâmetro será definido como o código de erro. Quando a chamada remota é concluída com êxito, o procedimento define o valor.

O parâmetro associado ao atributo [fault_status] não precisa ser especificado no arquivo IDL. Quando o parâmetro não é especificado, um novo parâmetro out do tipo error_status_t é gerado seguindo o último parâmetro definido no arquivo IDL do DCE.

É possível que os atributos [fault_status] e [comm_status] apareçam em uma única função, seja como atributos de função ou atributos de parâmetro. Se ambos os atributos forem atributos de função ou se eles se aplicarem ao mesmo parâmetro e nenhum erro ocorrer, a função ou parâmetro terá o valor error_status_ok. Caso contrário, ele contém o valor de código de status apropriado. Como os valores retornados para [fault_status] são diferentes dos valores retornados para [comm_status], os valores retornados são prontamente interpretados.

Confira também

Arquivo de Configuração de Aplicativo (ACF)

comm_status

error_status_t

nocode

out