atributo retval

  • Artigo

O atributo [retval] designa o parâmetro que recebe o valor retornado do membro.

return-type function-name(
    [out, retval [, optional-attributes]] data-type * param-name,
    ...);

Parâmetros

return-type

O tipo de dados do valor retornado do procedimento remoto.

function-name

O nome usado para invocar o procedimento remoto.

optional-attributes

Zero ou mais atributos MIDL.

tipo de dados

O tipo dos dados passados pelo parâmetro .

param-name

O nome do identificador do parâmetro.

Comentários

Você pode usar o atributo [retval] em parâmetros de membros de interface que descrevem métodos ou obtêm propriedades. (O atributo é necessário no último parâmetro de um método que tem o atributo[propget].) O parâmetro deve ter o atributo [out] e deve ser um tipo de ponteiro.

Não é possível aplicar o atributo [opcional] a um parâmetro [retval] .

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

Parâmetros com o atributo [retval] não são exibidos em navegadores orientados ao usuário.

Flags

IDLFLAG_FRETVAL

Exemplos

HRESULT MyMethod([out, retval] InMyFace** ReturnVal);
HRESULT MyOtherMethod([out, retval] VARIANT_BOOL* ReturnVal);

Confira também

Defaultvalue

Gerando uma biblioteca de tipos com MIDL

Lcid

Exemplo de arquivo ODL

Sintaxe de arquivo ODL

Opcional

out

propget

TYPEFLAGS