字段属性
字段属性是可应用于数组、结构、联合或字符数组的字段的属性:
例如,字段属性与数组声明结合使用,以指定数组的大小或包含有效数据的数组部分。 这可以通过将另一个参数、结构字段或常量表达式与数组相关联来完成。
[忽略] 属性指定要在封送过程中忽略的指针字段。 此类忽略的字段设置为在接收方端 NULL。
MIDL 提供 一致性、不同的,以及 打开的 数组。 如果在运行时确定数组的边界,则调用数组符合性。 [size_is] 属性指定数组的分配大小的上限,[max_is] 属性指定有效数组索引的值的上限。 有关详细信息,请参阅 [数组]。
如果在编译时确定数组的边界,则会调用数组,但在运行时确定传输元素的范围。 开放数组(也称为符合性变化数组)是一个数组,其上限和传输元素的范围在运行时确定。 若要确定数组的传输元素的范围,数组声明必须包括一个 [length_is]、 [first_is], 或 [last_is] 属性。
[length_is] 属性指定要传输的数组元素数,[first_is] 属性指定要传输的第一个数组元素的索引。 [last_is] 属性指定要传输的最后一个数组元素的索引。
字段属性指定联合鉴别器 [switch_is ] 。 当联合是过程参数时,联合鉴别器必须是同一过程的另一个参数。 当联合是结构的字段时,鉴别器必须是结构的另一个字段,其级别必须与联合字段相同。 该鉴别器 必须是布尔、char、int或 枚举 类型或解析为此类类型之一的类型。 有关详细信息,请参阅 非封装联合 和 [switch_is]。
[字符串] 字段属性指定一维字符或字节数组或指向零终止字符或字节流的指针将被视为字符串。 字符串属性仅适用于一维数组和指针。 元素类型限制为 字符、字节、wchar_t或解析为这些类型之一的命名类型。
有关显示字段属性的上下文的信息,请参阅 MIDL 数组、MIDL 结构以及 MIDL 联合。