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