propget-Attribut
Das [ propget-Attribut ] gibt eine Eigenschaftenaccessorfunktion an. Die Eigenschaft muss den gleichen Namen wie die Funktion aufweisen.
[propget [,optional-property-attributes]] return-type function-name( parameters);
Parameter
-
optional-property-attributes
-
Null oder mehr Eigenschaftsattribute.
-
rückgabetyp
-
Der Typ der von der Remoteprozedur zurückgegebenen Daten.
-
Funktionsname
-
Der Name der Remoteprozedur.
-
parameters
-
Null oder mehr Parameter für die Remoteprozedur.
Bemerkungen
Eine Funktion, die über das Propget-Attribut verfügt, sollte auch als letzten Parameter einen Zeigertyp mit den [ ] Out- und [ Retval-Attributen ] aufweisen. Wenn der letzte Parameter nicht über die [ Attribute out, retval ] verfügt, wird der Rückgabewert der Funktion als [ out- retval-Parameter ] behandelt. Beispielsweise eine Funktion mit dem Prototyp.
[propget] short MyFunction([in] long aLongValue);
wird als behandelt.
[propget] HRESULT MyFunction([in] long aLongValue, [out,retval] short *outValue);
Höchstens eines von [ propget, ] [ propput ] und [ propputref kann für eine Funktion angegeben ] werden.
Wenn das [ lcid-Attribut ] in der Parameterliste einer Funktion verwendet wird, die einen Parameter mit dem [ propput-Attribut ] enthält, muss der [ ] lcid-Parameter vor dem letzten Parameter liegen.
Flags
INVOKE _ PROPERTYGET
Beispiele
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);
}