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

return-type

Especifica o tipo de retorno da função.

function-name

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.

parameter-name

Especifica o nome do parâmetro opcional.

Comentários

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 obrigató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. Parâmetro [lcid] , se houver,
5. Parâmetro [retval]

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)

Confira também

Defaultvalue

Gerando uma biblioteca de tipos com MIDL

Lcid

Exemplo de arquivo ODL

Sintaxe de arquivo ODL

retval