atributo opcional

O atributo [opcional] especifica um parâmetro opcional para uma função membro.

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

Parâmetros

tipo de retorno

Especifica o tipo de retorno da função.

nome da função

Especifica o nome da função conforme definido no arquivo IDL.

outros atributos

Zero ou mais atributos MIDL opcionais.

tipo de parâmetro

O tipo de dados do parâmetro opcional.

nome do parâmetro

Especifica o nome do parâmetro opcional.

Observações

O atributo [opcional] só será válido se o parâmetro for do tipo VARIANT ou VARIANT *.

O compilador MIDL aceita a seguinte ordenação de parâmetro (da esquerda para a direita):

1. Parâmetros necessários (parâmetros que não têm os atributos [defaultvalue] ou [opcional] ),
2. Parâmetros opcionais com ou sem o atributo [defaultvalue],
3. Parâmetros com o atributo [opcional] e sem o atributo [defaultvalue],
4. [lcid] parâmetro, se houver,
5. [retval] parâmetro

Não é possível aplicar o atributo [opcional] a um parâmetro que também tenha os atributos[lcid] ou [retval].

Exemplos

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

Consulte também

Defaultvalue

Gerando uma biblioteca de tipos com MIDL

Lcid

Exemplo de arquivo ODL

Sintaxe de arquivo ODL

Retval