attribut comm_status
Das [comm_status] ACF-Attribut bewirkt, dass ein Fehlercode zurückgegeben wird, wenn während der Ausführung einer Funktion ein Kommunikationsfehler auftritt.
[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
, ...);
Parameter
-
ACF-funktionsattribute
-
Gibt null oder mehr ACF-Funktionsattribute an, z. B. [comm_status] und [nocode]. Funktionsattribute sind in eckige Klammern eingeschlossen. Null oder mehr Attribute können auf eine Funktion angewendet werden. Trennen Sie mehrere Funktionsattribute durch Kommas. Beachten Sie, dass [comm_status] nicht auch als Parameterattribute angezeigt werden kann, wenn [comm_status] als Funktionsattribute angezeigt wird.
-
Funktionsname
-
Gibt den Namen der Funktion an, wie in der IDL-Datei definiert.
-
ACF-parameter-attribute
-
Gibt Attribute an, die für einen Parameter gelten. Beachten Sie, dass null, ein oder mehrere Attribute auf den Parameter angewendet werden können. Trennen Sie mehrere Parameterattribute durch Kommas. Parameterattribute werden in eckige Klammern eingeschlossen. IDL-Parameterattribute, z. B. Richtungsattribute, sind im ACF nicht zulässig. Beachten Sie, dass [comm_status] nicht auch als Funktionsattribute angezeigt werden kann, wenn [comm_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, der in der IDL-Datei definiert ist.
Bemerkungen
Das [comm_status] -Attribut kann entweder als Funktionsattribut oder als Parameterattribute verwendet werden, kann aber nur einmal pro Funktion angezeigt werden. Sie kann entweder auf die Funktion oder auf einen Parameter in jeder Funktion angewendet werden.
Das Attribut [comm_status] kann nur auf Funktionen angewendet werden, die den Typ error_status_t zurückgeben. Wenn während der Ausführung der Funktion ein Kommunikationsfehler auftritt, wird ein Fehlercode zurückgegeben.
Wenn [comm_status] als Parameterattribute verwendet wird, muss der Parameter in der IDL-Datei definiert werden und muss ein [out] -Parameter vom Typ error_status_t sein. Wenn während der Ausführung der Funktion ein Kommunikationsfehler auftritt, wird der Parameter auf den Fehlercode festgelegt. Wenn der Remoteaufruf erfolgreich abgeschlossen wurde, legt die Prozedur den Wert fest.
Es ist möglich, dass sowohl die Attribute [comm_status] als auch [fault_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, hat die Funktion oder der Parameter den Wert error_status_ok. Andernfalls enthält sie den entsprechenden [comm_status] oder [fault_status] -Wert. Da sich für [comm_status] zurückgegebene Werte von den für [fault_status] zurückgegebenen Werten unterscheiden, werden die zurückgegebenen Werte leicht interpretiert.
Siehe auch