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

Fichier de définition d’interface (IDL)

midl_user_allocate

out out