Attributs de champ

Les attributs de champ sont les attributs qui peuvent être appliqués aux champs d’un tableau, d’une structure, d’une Union ou d’un tableau de caractères :

Par exemple, les attributs de champ sont utilisés conjointement avec les déclarations de tableau pour spécifier la taille du tableau ou la partie du tableau qui contient des données valides. Pour ce faire, vous associez un autre paramètre, un champ de structure ou une expression constante au tableau.

L' [ attribut ignore ] désigne les champs de pointeur à ignorer pendant le processus de marshaling. Un tel champ ignoré a la valeur null côté récepteur.

MIDL fournit des tableaux conformes, variables et ouverts . Un tableau est appelé conforme si ses limites sont déterminées au moment de l’exécution. La [ taille _ est l' ] attribut désignant la limite supérieure de la taille d’allocation du tableau et l' [ attribut Max _ is ] désigne la limite supérieure de la valeur d’un index de tableau valide. Pour plus d’informations, consultez [ tableaux ] .

Un tableau est appelé varying si ses limites sont déterminées au moment de la compilation, mais la plage d’éléments transmis est déterminée au moment de l’exécution. Un tableau ouvert (également appelé tableau variable conforme) est un tableau dont la limite supérieure et la plage d’éléments transmis sont déterminées au moment de l’exécution. Pour déterminer la plage d’éléments transmis d’un tableau, la déclaration de tableau doit inclure une [ longueur _ ] , [ First _ is ] ou [ Last _ is ] attribute.

La [ longueur _ est ] l’attribut désignant le nombre d’éléments de tableau à transmettre et le [ premier attribut _ est ] désignant l’index du premier élément de tableau à transmettre. Le [ dernier _ attribut ] est désignant l’index du dernier élément de tableau à transmettre.

Le [ commutateur _ est ] un attribut de champ qui désigne un discriminateur d’Union. Lorsque l’Union est un paramètre de procédure, le discriminateur d’Union doit être un autre paramètre de la même procédure. Lorsque l’Union est un champ d’une structure, le discriminateur doit être un autre champ de la structure au même niveau que le champ Union. Le discriminateur doit être un type booléen, char, intou enum , ou un type qui correspond à l’un de ces types. Pour plus d’informations, consultez Unions [ _ non ] encapsulées et commutateur.

L' [ attribut de champ de chaîne ] désigne qu’un caractère unidimensionnel ou un tableau d’octets, ou un pointeur vers un flux de caractères ou d’octets se terminant par zéro, doit être traité comme une chaîne. L’attribut de chaîne s’applique uniquement aux tableaux et pointeurs unidimensionnels. Le type d’élément est limité à char, Byte, WCHAR _ tou à un type nommé qui correspond à l’un de ces types.

Pour plus d’informations sur le contexte dans lequel les attributs de champ s’affichent, consultez tableaux MIDL, structures MIDLet unions MIDL.