in (attribut)
L’attribut [in] indique qu’un paramètre doit être passé de la procédure appelante à la procédure appelée.
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
[ in [ , parameter-attribute-list ] ] type-specifier [declarator]
, ...);
Paramètres
-
function-attribute-list
-
Spécifie zéro ou plusieurs attributs qui s’appliquent à la fonction. Les attributs de fonction valides sont [callback], [local], l’attribut de pointeur [ref], [unique] ou [ptr] et les attributs d’utilisation [string], [ignore] et [context_handle].
-
spécificateur de type
-
Spécifie un type ou un identificateur de type base_type, struct, union ou enum . Une spécification de stockage facultative peut précéder le spécificateur de type.
-
pointeur-déclarateur
-
Spécifie zéro ou plusieurs déclarateurs de pointeur. Un déclarateur de pointeur est identique au déclarateur de pointeur utilisé dans C ; il est construit à partir de l’indicateur *, des modificateurs tels que la distance et du qualificateur const.
-
nom de la fonction
-
Spécifie le nom de la procédure distante.
-
parameter-attribute-list
-
Spécifie zéro ou plusieurs attributs appropriés pour le type de paramètre spécifié. Les attributs de paramètre avec l’attribut [in] peuvent également prendre l’attribut directionnel [out] ; les attributs de champ [first_is],[last_is], [length_is], [max_is], [size_is] et [switch_type]; l’attribut pointeur [ref], [unique] ou [ptr]; et les attributs d’utilisation [context_handle] et [string]. L’attribut d’utilisation [ignore] ne peut pas être utilisé comme attribut de paramètre. Séparez plusieurs attributs 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 Tableaux et Sized-Pointer Attributs, tableaux et 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 [in] a un attribut inverse, [out], qui indique qu’un paramètre doit être retourné de la procédure appelée à la procédure appelante. Les attributs [in] et [out] sont appelés attributs de paramètre directionnel, car ils spécifient la direction dans laquelle les paramètres sont passés. Un paramètre peut être défini comme [in], [out] ou [in, out].
L’attribut [in] identifie les paramètres qui sont marshalés par le stub client pour la transmission au serveur.
L’attribut [in] est appliqué à un paramètre par défaut lorsqu’aucun attribut de paramètre directionnel n’est spécifié.
Exemples
HRESULT MyFunction([in] short count);
Voir aussi