annoter l’attribut

L’attribut [ annotation ] vous permet de spécifier une chaîne d’annotation SAL pour la méthode, le paramètre ou le champ de structure spécifié.

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

Paramètres

string

Chaîne d’annotation SAL spécifiée.

function-attribute-List

Spécifie zéro, un ou plusieurs attributs qui s’appliquent à la fonction. Les attributs de fonction valides incluent le [ ] rappel; les attributs de pointeur [ Ref ], [ unique ]ou [ ptr ]; et les attributs d’utilisation [ chaîne ], [ Ignorer ]et [ _ handle ] de contexte. Plusieurs attributs doivent être séparés par des virgules.

déclarateur de fonction

Spécifie le spécificateur de type, le nom de fonction et la liste de paramètres pour la fonction.

spécificateur de type

Spécifie un type de base _, un [ struct ], une Unionou un type [ enum ] ou un identificateur de type. Une spécification de stockage facultative peut précéder le type-specifier.

pointeur-déclarateur

Spécifie zéro ou plusieurs déclarateurs de pointeur. Un déclarateur de pointeur est identique à un déclarateur de pointeur utilisé dans C ; elle est construite à partir de l' * indicateur, de modificateurs tels que Far et de l’identificateur [ const ].

nom de fonction

Spécifie le nom de la procédure distante.

Parameter-attribute-List

Spécifie zéro, un ou plusieurs attributs appropriés pour le type de paramètre. Les attributs de paramètre avec l’attribut in peuvent également prendre l' [ attribut ] directionnel. lesattributs de champ [ _ sont ], [ Last _ ] is, [ Length _ is ], [ Max _ is ], [ size _ is ]et [ Switch _ type ]; les attributs [ de ] pointeur [ Ref ], [ unique ]ou [ ptr ]; et les attributs d’utilisation [ _ handle ] de contexte et [ chaîne ]. L’attribut d’utilisation [ ignore ] ne peut pas être utilisé en tant qu’attribut de paramètre. Plusieurs attributs doivent être séparés par des virgules.

declarator

Spécifie les déclarateurs C standard, tels que les identificateurs, les déclarateurs de pointeurs et les déclarateurs de tableau. Pour plus d’informations, consultez tableau et Sized-Pointer attributs, [ tableaux ], tableaux et pointeurs. Le déclarateur de paramètre dans le déclarateur de fonction, tel que le nom du paramètre, est facultatif.

Notes

L’attribut [ annoter ] permet de remplacer les annotations SAL générées par MIDL ou de les ajouter à des endroits où MIDL ne génère pas explicitement d’annotation. Si /SAL n’est pas spécifié sur la ligne de commande, cet attribut est ignoré.

Voir aussi

Syntaxe générale de la ligne de commande MIDL

/sal

/SAL _ local