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