fault_status-Attribut
Das [fault_status] ACF-Attribut gibt an, dass ein Fehlercode vom Typ error_status_t einen Fehler der Remoteprozedur angibt und nicht andere Arten von Problemen wie z. B. Kommunikationsfehler.
[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-Funktionsattribute
-
Gibt null oder mehr ACF-Funktionsattribute an, z. B. [fault_status] und [nocode]. Funktionsattribute werden in eckige Klammern eingeschlossen. Beachten Sie, dass null oder mehr Attribute auf eine Funktion angewendet werden können. Trennen Sie mehrere Funktionsattribute durch Kommas. Beachten Sie außerdem, dass [fault_status] nicht auch als Parameterattribute angezeigt werden kann, wenn [fault_status] als Funktionsattribute angezeigt wird.
-
Funktionsname
-
Gibt den Namen der Funktion an, wie in der IDL-Datei definiert.
-
ACF-Parameterattribute
-
Gibt Attribute an, die für einen Parameter gelten. Beachten Sie, dass null oder mehr Attribute auf den Parameter angewendet werden können. Parameterattribute werden in eckige Klammern eingeschlossen. Trennen Sie mehrere Parameterattribute durch Kommas. IDL-Parameterattribute, z. B. direktionale Attribute, sind in der ACF nicht zulässig. Beachten Sie, dass [fault_status] nicht auch als Funktionsattribute angezeigt werden kann, wenn [fault_status] als Parameterattribute angezeigt wird.
-
Parametername
-
Gibt den Parameter für die Funktion an, wie in der IDL-Datei definiert. Jeder Parameter für die Funktion muss in derselben Sequenz angegeben werden, wobei derselbe Name verwendet wird, wie in der IDL-Datei definiert.
Das [fault_status] -Attribut kann entweder als Funktionsattribute oder als Parameterattribute verwendet werden, es kann jedoch nur einmal pro Funktion angezeigt werden. Sie kann entweder auf die Funktion selbst oder auf einen Parameter in jeder Funktion angewendet werden.
Das [fault_status]- Attribut kann nur auf Funktionen angewendet werden, die den Typ error_status_t zurückgeben. Wenn die Remoteprozedur so fehlschlägt, dass eine Fehler-PDU zurückgegeben wird, wird ein Fehlercode zurückgegeben.
Wenn [fault_status] als Parameterattribute verwendet wird, muss der Parameter ein [out] -Parameter vom Typ error_status_t sein. Wenn ein Serverfehler auftritt, wird der Parameter auf den Fehlercode festgelegt. Wenn der Remoteaufruf erfolgreich abgeschlossen wurde, legt die Prozedur den Wert fest.
Der Parameter, der dem Attribut [fault_status] zugeordnet ist, muss nicht in der IDL-Datei angegeben werden. Wenn der Parameter nicht angegeben ist, wird nach dem letzten Parameter, der in der DCE-IDL-Datei definiert wurde, ein neuer out-Parameter vom Typ error_status_t generiert.
Es ist möglich, dass sowohl die Attribute [fault_status] als auch [comm_status] in einer einzelnen Funktion angezeigt werden, entweder als Funktionsattribute oder als Parameterattribute. Wenn beide Attribute Funktionsattribute sind oder für denselben Parameter gelten und kein Fehler auftritt, weist die Funktion oder der Parameter den Wert error_status_ok. Andernfalls enthält sie den entsprechenden status Codewert. Da sich für [fault_status] zurückgegebene Werte von den für [comm_status] zurückgegebenen Werten unterscheiden, werden die zurückgegebenen Werte problemlos interpretiert.