Annotate-Attribut

Mit dem Attribut [annotate] können Sie eine SAL-Anmerkungszeichenfolge für das angegebene Methoden-, Parameter- oder Strukturfeld angeben.

[ annotation("string",  [, function-attribute-list] ] function-declarator ;
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
    [ annotation("string") [ , parameter-attribute-list ] ] type-specifier [declarator]
    , ...);

Parameter

string

Angegebene SAL-Anmerkungszeichenfolge.

function-attribute-list

Gibt null oder mehr Attribute an, die für die Funktion gelten. Gültige Funktionsattribute sind [Rückruf]; die Zeigerattribute [ref], [eindeutig] oder [ptr]; und die Verwendungsattribute [Zeichenfolge], [ignorieren] und [context_handle]. Mehrere Attribute müssen durch Kommas getrennt werden.

Funktionsdeklarator

Gibt den Typbezeichner, den Funktionsnamen und die Parameterliste für die Funktion an.

Typspezifizierer

Gibt einen base_type-, [Struktur]-, Union- oder [Enumeration] -Typ oder Typbezeichner an. Eine optionale Speicherspezifikation kann dem Typbezeichner vorangestellt werden.

Zeiger-Deklarator

Gibt null oder mehr Zeiger-Deklaratoren an. Ein Zeigerdeklarations-Deklarator ist mit einem Zeiger-Deklarator identisch, der in C verwendet wird. es wird aus dem *-Bezeichner, Modifizierern wie far und dem Qualifizierer [const] erstellt.

Funktionsname

Gibt den Namen der Remoteprozedur an.

parameter-attribute-list

Gibt null oder mehr Attribute an, die für den Parametertyp geeignet sind. Parameterattribute mit dem [in] -Attribut können auch das richtungsgerichtete Attribut [out]; die Feldattribute [first_is], [last_is], [length_is], [max_is], [size_is] und [switch_type]; die Zeigerattribute [ref], [eindeutig] oder [ptr]; und die Nutzungsattribute [context_handle] und [Zeichenfolge]. Das Verwendungsattribut [ignore] kann nicht als Parameterattribute verwendet werden. Mehrere Attribute müssen durch Kommas getrennt werden.

declarator

Gibt Standard-C-Deklaratoren an, z. B. Bezeichner, Zeiger-Deklaratoren und Array-Deklaratoren. Weitere Informationen finden Sie unter Array- und Sized-Pointer attribute, [Arrays] und Arrays und Zeiger. Der Parameterdeklarationsator im Funktionsdeklarationsator, z. B. der Parametername, ist optional.

Bemerkungen

Das Attribut [annotate] ermöglicht das Überschreiben von MIDL-generierten SAL-Anmerkungen oder das Hinzufügen an Stellen, an denen MIDL keine Anmerkung explizit generiert. Wenn /sal in der Befehlszeile nicht angegeben wird, wird dieses Attribut ignoriert.

Siehe auch

Allgemeine MIDL-Befehlszeilensyntax

/Sal

/sal_local