first_is (attributo)

L'attributo [first_is] specifica l'indice del primo elemento della matrice da trasmettere.

first_is(limited-expression-list)

Parametri

limited-expression-list

Specifica una o più espressioni del linguaggio C. Ogni espressione restituisce un numero intero che rappresenta l'indice di matrice del primo elemento della matrice da trasmettere. Il compilatore MIDL supporta espressioni condizionali, espressioni logiche, espressioni relazionali ed espressioni aritmetiche. MIDL non consente chiamate di funzione nelle espressioni e non consente operatori di incremento e decremento. Separare più espressioni con virgole.

Commenti

Se l'attributo [first_is] non è presente o se l'indice specificato è un numero negativo, l'elemento matrice zero è il primo elemento trasmesso.

L'attributo [first_is] può essere utile anche per determinare i valori degli indici di matrice corrispondenti all'attributo [last_is] o [length_is] quando questi attributi non sono specificati. La relazione tra questi indici di matrice è:

length = last - first + 1

Anche la relazione seguente deve contenere:

0 <= first_is <= max_is

La relazione seguente deve contenere quando [max_is] <= 0:

first_is == 0

L'attributo [first_is] non può essere usato contemporaneamente all'attributo [string].

L'uso di un'espressione costante con l'attributo [first_is] è un uso non appropriato dell'attributo . È legale, ma inefficiente e comporterà un marshalling più lento del codice.

Esempi

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

Vedere anche

field_attributes

File IDL (Interface Definition)

last_is

length_is

max_is

min_is

size_is

string