Freigeben über


error_status_t-Attribut

Die error_status_t Schlüsselwort (keyword) legt einen Typ für ein Objekt fest, der Informationen zu kommunikationsbasierten status oder Fehler status enthält.

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

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

Parameter

ACF-Funktionsattribute

Gibt null oder mehr ACF-Funktionsattribute an, z. B. [comm_status], [fault_status] oder [nocode]. Funktionsattribute werden in eckige Klammern eingeschlossen. Null oder mehr Attribute können auf eine Funktion angewendet werden. Trennen Sie mehrere Funktionsattribute durch Kommas.

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, 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. direktionale Attribute, sind in der ACF nicht zulässig.

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.

Bemerkungen

Der error_status_t Typ wird als Teil der Ausnahmebehandlungsarchitektur in IDL verwendet. Dieser Typ wird einem long-Wert ohne Vorzeichenzugeordnet. Anwendungen, die Fehlersituationen abfangen, verfügen über einen [out] -Parameter oder einen Rückgabetyp einer als error_status_t angegebenen Prozedur und qualifizieren die error_status_t mit den Attributen [comm_status] oder [fault_status] im ACF. Wenn der Parameter oder Rückgabetyp nicht mit den Attributen [comm_status] oder [fault_status] qualifiziert wurde, funktioniert der Parameter so, als wäre er ein Long ohne Vorzeichen.

Ab Version 2.0 generiert der MIDL-Compiler Stubs, die die richtige Fehlerbehandlungsarchitektur enthalten. In früheren Versionen des MIDL-Compilers wurde jedoch ein Parameter oder ein Rückgabetyp von error_status_t so behandelt, als ob die Attribute [comm_status] und [fault_status] angewendet würden, auch wenn sie nicht vorhanden wären. Mit MIDL 2.0 oder höher müssen Sie die Attribute [comm_status] und [fault_status] explizit auf den Parameter oder die Prozedur im ACF anwenden.

Der error_status_t Typ ist einer der vordefinierten Typen der Schnittstellendefinitionssprache. Vordefinierte Typen können als Typspezifizierer in typedef-Deklarationen , in allgemeinen Deklarationen und in Funktionsdeklaratoren (entweder als Funktionsrückgabetyp oder als Parametertypbezeichner) angezeigt werden.

Siehe auch

comm_status

fault_status

IDL-Datei (Interface Definition)

Lange

out

Typedef

Unsigned