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] 返回的值不同，因此很容易解释返回的值。

另请参阅

应用程序配置文件 (ACF)

error_status_t

fault_status

nocode

out