comm_status 属性
[comm_status] ACF 属性会导致在执行函数期间发生通信错误时返回错误代码。
[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
, ...);
参数
-
ACF-function-attributes
-
指定零个或多个 ACF 函数属性，如 [comm_status] 和 [nocode]。 函数属性括在方括号中。 零个或多个属性可以应用于函数。 用逗号分隔多个函数属性。 请注意，如果 [comm_status] 显示为函数属性，则它不能也显示为参数属性。
-
function-name
-
指定 IDL 文件中定义的函数的名称。
-
ACF-parameter-attributes
-
指定应用于参数的属性。 请注意，零个、一个或多个属性可以应用于 参数。 用逗号分隔多个参数属性。 参数属性括在方括号中。 ACF 中不允许使用 IDL 参数属性，例如方向属性。 请注意，如果 [comm_status] 显示为参数属性，则它不能也显示为函数属性。
-
parameter-name
-
指定 IDL 文件中定义的函数的参数。 必须使用 IDL 文件中定义的相同名称，以相同的顺序指定函数的每个参数。
备注
[comm_status] 属性可用作函数属性或参数属性，但每个函数只能出现一次。 它可以应用于 函数，也可以应用于每个函数中的一个参数。
[comm_status] 属性只能应用于返回类型error_status_t的函数。 执行函数期间发生通信错误时，将返回错误代码。
当 [comm_status] 用作参数属性时，该参数必须在 IDL 文件中定义，并且必须是类型为 error_status_t 的 [out] 参数。 执行函数期间发生通信错误时， 参数设置为错误代码。 远程调用成功完成后，该过程将设置 值。
[comm_status] 和 [fault_status] 属性都可以作为函数属性或参数属性出现在单个函数中。 如果这两个属性都是函数属性，或者它们应用于同一个参数且未发生错误，则函数或参数 的值error_status_ok。 否则，它包含相应的 [comm_status] 或 [fault_status] 值。 由于为 [comm_status] 返回的值与 [fault_status] 返回的值不同，因此很容易解释返回的值。
另请参阅