atributo fault_status
El atributo ACF [fault_status] especifica que un código de error de tipo error_status_t indica un error del procedimiento remoto, en lugar de otros tipos de problemas, como errores de comunicación.
[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 cero o más atributos de función ACF, como [fault_status] y [nocode]. Los atributos de función se incluyen entre corchetes. Tenga en cuenta que se pueden aplicar cero o más atributos a una función. Separe varios atributos de función con comas. Tenga en cuenta también que si [fault_status] aparece como un atributo de función, tampoco puede aparecer como un atributo de parámetro.
-
function-name
-
Especifica el nombre de la función tal y como se define en el archivo IDL.
-
ACF-parameter-attributes
-
Especifica los atributos que se aplican a un parámetro. Tenga en cuenta que se pueden aplicar cero o más atributos al parámetro . Los atributos de parámetro se incluyen entre corchetes. Separe varios atributos de parámetro con comas. Los atributos de parámetro IDL, como los atributos direccionales, no se permiten en ACF. Tenga en cuenta que si [fault_status] aparece como un atributo de parámetro, tampoco puede aparecer como un atributo de función.
-
parameter-name
-
Especifica el parámetro de la función tal y como se define en el archivo IDL. Cada parámetro de la función debe especificarse en la misma secuencia, con el mismo nombre que se define en el archivo IDL.
Observaciones
El atributo [fault_status] se puede usar como atributo de función o como atributo de parámetro, pero solo puede aparecer una vez por función. Se puede aplicar a la propia función o a un parámetro de cada función.
El atributo [fault_status] solo se puede aplicar a funciones que devuelven el tipo error_status_t. Cuando se produce un error en el procedimiento remoto de forma que se devuelva una PDU de error, se devuelve un código de error.
Cuando [fault_status] se usa como atributo de parámetro, el parámetro debe ser un parámetro [out] de tipo error_status_t. Si se produce un error de servidor, el parámetro se establece en el código de error. Cuando la llamada remota se completa correctamente, el procedimiento establece el valor .
El parámetro asociado al atributo [fault_status] no tiene que especificarse en el archivo IDL. Cuando no se especifica el parámetro , se genera un nuevo parámetro out de tipo error_status_t después del último parámetro definido en el archivo IDL de DCE.
Es posible que los atributos [fault_status] y [comm_status] aparezcan en una sola función, ya sea como atributos de función o atributos de parámetro. Si ambos atributos son atributos de función, o si se aplican al mismo parámetro y no se produce ningún error, la función o el parámetro tiene el valor error_status_ok. De lo contrario, contiene el valor de código de estado adecuado. Dado que los valores devueltos para [fault_status] son diferentes de los valores devueltos para [comm_status], los valores devueltos se interpretan fácilmente.
Vea también