atributo propget

  • Artigo

O atributo [propget] especifica uma função de acessador de propriedade. A propriedade deve ter o mesmo nome que a função .

[propget [,optional-property-attributes]] return-type function-name( parameters);

Parâmetros

optional-property-attributes

Zero ou mais atributos de propriedade.

return-type

O tipo dos dados retornados pelo procedimento remoto.

function-name

O nome do procedimento remoto.

parameters

Zero ou mais parâmetros para o procedimento remoto.

Comentários

Uma função que tem o atributo propget também deve ter, como seu último parâmetro, um tipo de ponteiro com os atributos [out] e [retval] . Se o último parâmetro não tiver os atributos [out, retval], o valor retornado da função será tratado como um parâmetro [out, retval]. Por exemplo, uma função com o protótipo

[propget] short MyFunction([in] long aLongValue);

é tratado como

[propget] HRESULT MyFunction([in] long aLongValue, [out,retval] short *outValue);

No máximo, um dos [propget], [propput], e [propputref] pode ser especificado para uma função.

Se o atributo [lcid] for usado na lista de parâmetros de uma função que contém um parâmetro com o atributo [propput] , o parâmetro [lcid] deverá ser o segundo ao último.

Flags

INVOKE_PROPERTYGET

Exemplos

interface MyInterface : IDispatch                         
{                
    [propget, 
     helpstring("A meaningful comment.")] HRESULT Method1(
         [out, retval] int* ReturnVal); 

    [propput, 
     helpstring("Another meaningful comment.")] HRESULT Method1(
         [in] int Value);
        
    [propget, 
     helpstring("A meaningful comment."), id(1)] HRESULT Method2(
         [out, retval] YourInterface** ReturnVal); 

    [propputref, 
     helpstring("Another meaningful comment."), 
     id(1)] HRESULT Method2([in] YourPoint* Point);
}

Confira também

Gerando uma biblioteca de tipos com MIDL

Exemplo de arquivo ODL

Sintaxe de arquivo ODL

out

retval

propput

propputref

TYPEFLAGS