атрибут 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], возвращаемые значения легко интерпретируются.
См. также раздел