optional (attributo)

L'attributo [facoltativo] specifica un parametro facoltativo per una funzione membro.

return-type function-name([optional [, other-attributes]] parameter-type parameter-name)

Parametri

tipo restituito

Specifica il tipo restituito della funzione.

function-name

Specifica il nome della funzione come definito nel file IDL.

altri attributi

Zero o più attributi MIDL facoltativi.

parametro-type

Tipo di dati del parametro facoltativo.

parameter-name

Specifica il nome del parametro facoltativo.

Commenti

L'attributo [facoltativo] è valido solo se il parametro è di tipo VARIANT o VARIANTÂ *.

Il compilatore MIDL accetta l'ordinamento dei parametri seguente (da sinistra a destra):

  1. Parametri obbligatori (parametri che non hanno gli attributi [defaultvalue] o [facoltativo] ),
  2. Parametri facoltativi con o senza l'attributo [defaultvalue] ,
  3. Parametri con l'attributo [facoltativo] e senza l'attributo [defaultvalue] ,
  4. [lcid] parametro, se disponibile,
  5. [retval] parametro

Non è possibile applicare l'attributo [facoltativo] a un parametro che include anche gli attributi [lcid] o [retval].

Esempi

HRESULT MyFunc([in, optional] VARIANT Param1, 
               [out, optional] VARIANT Param2)

Vedere anche

Defaultvalue

Generazione di una libreria dei tipi con MIDL

Lcid

Esempio di file ODL

Sintassi dei file ODL

retval