retval-Attribut
Das [retval] -Attribut gibt den Parameter an, der den Rückgabewert des Elements empfängt.
return-type function-name(
[out, retval [, optional-attributes]] data-type * param-name,
...);
-
Rückgabetyp
-
Der Datentyp des Rückgabewerts der Remoteprozedur.
-
Funktionsname
-
Der Name, der zum Aufrufen der Remoteprozedur verwendet wird.
-
optional-attribute
-
Null oder mehr MIDL-Attribute.
-
Datentyp
-
Der Typ der Daten, die über den Parameter übergeben werden.
-
param-name
-
Der Bezeichnername des Parameters.
Sie können das [retval] -Attribut für Parameter von Schnittstellenmembern verwenden, die Methoden beschreiben oder Eigenschaften abrufen. (Das Attribut ist für den letzten Parameter einer Methode erforderlich, die über das Attribut [propget] verfügt.) Der Parameter muss über das Attribut [out] verfügen und muss ein Zeigertyp sein.
Sie können das Attribut [optional] nicht auf einen [retval] -Parameter anwenden.
Der MIDL-Compiler akzeptiert die folgende Parameterreihenfolge (von links nach rechts):
- Erforderliche Parameter (Parameter, die nicht über die Attribute [defaultvalue] oder [optional] verfügen ).
- Optionale Parameter mit oder ohne [defaultvalue] -Attribut.
- Parameter mit dem Attribut [optional] und ohne das Attribut [defaultvalue]
- [lcid] -Parameter, falls vorhanden.
- [retval] -Parameter.
Parameter mit dem Attribut [retval] werden in benutzerorientierten Browsern nicht angezeigt.
IDLFLAG_FRETVAL
HRESULT MyMethod([out, retval] InMyFace** ReturnVal);
HRESULT MyOtherMethod([out, retval] VARIANT_BOOL* ReturnVal);