атрибут fault_status

Атрибут ACF [fault_status] указывает, что код ошибки типа error_status_t указывает на сбой удаленной процедуры, а не другие типы проблем, таких как ошибки связи.

[fault_status [ , ACF-function-attributes ] ] function-name(
    [ [ ACF-parameter-attributes ] ] parameter-name
    , ... );

[ [ ACF-function-attributes ] ] function-name(
    [fault_status [ , ACF-parameter-attributes ] ] parameter-name
    , ... );

Параметры

Атрибуты функции ACF

Задает ноль или несколько атрибутов функции ACF, таких как [fault_status] и [nocode]. Атрибуты функции заключаются в квадратные скобки. Обратите внимание, что к функции можно применить ноль или несколько атрибутов. Разделяйте несколько атрибутов функции запятыми. Также обратите внимание, что если [fault_status] отображается как атрибут функции, он также не может отображаться как атрибут параметра.

function-name

Указывает имя функции, определенное в IDL-файле.

Атрибуты параметра ACF

Задает атрибуты, применяемые к параметру. Обратите внимание, что к параметру можно применить ноль или несколько атрибутов. Атрибуты параметров заключаются в квадратные скобки. Разделяйте несколько атрибутов параметров запятыми. Атрибуты параметров IDL, такие как атрибуты направления, не допускаются в ACF. Обратите внимание, что если [fault_status] отображается в качестве атрибута параметра, он также не может отображаться как атрибут функции.

parameter-name

Задает параметр для функции, как определено в IDL-файле. Каждый параметр для функции должен быть указан в одной последовательности, используя то же имя, что и в IDL-файле.

Комментарии

Атрибут [fault_status] можно использовать как атрибут функции или как атрибут параметра, но он может отображаться только один раз для каждой функции. Его можно применить либо к самой функции, либо к одному параметру в каждой функции.

Атрибут [fault_status] может применяться только к функциям, возвращающим тип error_status_t. Если удаленная процедура завершается сбоем, что приводит к возврату PDU сбоя, возвращается код ошибки.

Если в качестве атрибута параметра используется [fault_status] , параметр должен быть параметром [out] типа error_status_t. При возникновении ошибки сервера параметру присваивается код ошибки. После успешного завершения удаленного вызова процедура задает значение .

Параметр, связанный с атрибутом [fault_status] , не обязательно указывать в IDL-файле. Если параметр не указан, создается новый параметр out типа error_status_t после последнего параметра, определенного в IDL-файле DCE.

Атрибуты [fault_status] и [comm_status] могут отображаться в одной функции как атрибуты функции или атрибуты параметра. Если оба атрибута являются атрибутами функции или если они применяются к одному и тому же параметру без ошибок, функция или параметр имеет значение error_status_ok. В противном случае он содержит соответствующее значение кода состояния. Поскольку значения, возвращаемые для [fault_status] , отличаются от значений, возвращаемых для [comm_status], возвращаемые значения легко интерпретируются.

См. также раздел

Файл конфигурации приложения (ACF)

comm_status

error_status_t

nocode

out