atributo comm_status
El atributo ACF [comm_status] hace que se devuelva un código de error cuando se produce un error de comunicación durante la ejecución de una función.
[comm_status [ , ACF-function-attributes ] ]
error_status_t function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ...);
[ [ ACF-function-attributes ] ] function-name(
[comm_status [ , ACF-parameter-attributes ] ] error_status_t name
, ...);
Parámetros
-
ACF-function-attributes
-
Especifica cero o más atributos de función ACF, como [comm_status] y [nocode]. Los atributos de función se incluyen entre corchetes. Se pueden aplicar cero o más atributos a una función. Separe varios atributos de función con comas. Tenga en cuenta que si [comm_status] aparece como un atributo de función, tampoco puede aparecer como atributo de parámetro.
-
nombre de función
-
Especifica el nombre de la función tal 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, uno o más atributos al parámetro . Separe varios atributos de parámetro con comas. Los atributos de parámetro se incluyen entre corchetes. Los atributos de parámetro IDL, como los atributos direccionales, no se permiten en el ACF. Tenga en cuenta que si [comm_status] aparece como un atributo de parámetro, tampoco puede aparecer como atributo de función.
-
parameter-name
-
Especifica el parámetro de la función tal 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.
Comentarios
El atributo [comm_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 función o a un parámetro de cada función.
El atributo [comm_status] solo se puede aplicar a las funciones que devuelven el tipo error_status_t. Cuando se produce un error de comunicación durante la ejecución de la función, se devuelve un código de error.
Cuando [comm_status] se usa como atributo de parámetro, el parámetro debe definirse en el archivo IDL y debe ser un parámetro [out] de tipo error_status_t. Cuando se produce un error de comunicación durante la ejecución de la función, el parámetro se establece en el código de error. Cuando la llamada remota se completa correctamente, el procedimiento establece el valor .
Es posible que los atributos [comm_status] y [fault_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 [comm_status] o [fault_status]. Dado que los valores devueltos para [comm_status] son diferentes de los valores devueltos para [fault_status], los valores devueltos se interpretan fácilmente.
Consulte también