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 retorno

Especifica o tipo de retorno da função.

Nome da função

Especifica o nome da função conforme definido no ficheiro 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] é válido apenas se o parâmetro for do tipo VARIANT ou VARIANT *.

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

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

Não pode 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

valor padrão

Gerando uma biblioteca de tipos com MIDL

LCID

Exemplo de ficheiro ODL

Sintaxe de ficheiros ODL

Retval