first_is (atributo)

El atributo [first_is] especifica el índice del primer elemento de matriz que se va a transmitir.

first_is(limited-expression-list)

Parámetros

limited-expression-list

Especifica una o varias expresiones de lenguaje C. Cada expresión se evalúa como un entero que representa el índice de matriz del primer elemento de matriz que se va a transmitir. El compilador MIDL admite expresiones condicionales, expresiones lógicas, expresiones relacionales y expresiones aritméticas. MIDL no permite invocaciones de función en expresiones y no permite operadores de incremento y decremento. Separe varias expresiones con comas.

Comentarios

Si el atributo [first_is] no está presente o si el índice especificado es un número negativo, el elemento de matriz cero es el primer elemento transmitido.

El atributo [first_is] también puede ayudar a determinar los valores de los índices de matriz correspondientes al atributo [last_is] o [length_is] cuando no se especifican estos atributos. La relación entre estos índices de matriz es:

length = last - first + 1

La siguiente relación también debe contener:

0 <= first_is <= max_is

La siguiente relación debe contener cuando [max_is] <= 0:

first_is == 0

El atributo [first_is] no se puede usar al mismo tiempo que el atributo [string].

El uso de una expresión constante con el atributo [first_is] es un uso inadecuado del atributo. Es legal, pero ineficaz, y dará como resultado una serialización más lenta del código.

Ejemplos

HRESULT Proc1(
    [in] short First,
    [first_is(First)] Arr[10]);

Vea también

field_attributes

Archivo de definición de interfaz (IDL)

last_is

length_is

max_is

min_is

size_is

string