retval (attribut)
L’attribut [retval] désigne le paramètre qui reçoit la valeur de retour du membre.
return-type function-name(
[out, retval [, optional-attributes]] data-type * param-name,
...);
-
return-type
-
Type de données de la valeur de retour de la procédure distante.
-
function-name
-
Nom utilisé pour appeler la procédure distante.
-
optional-attributes
-
Zéro ou plusieurs attributs MIDL.
-
type de données
-
Type des données transmises via le paramètre .
-
param-name
-
Nom d’identificateur du paramètre.
Vous pouvez utiliser l’attribut [retval] sur les paramètres des membres de l’interface qui décrivent des méthodes ou obtiennent des propriétés. (L’attribut est requis sur le dernier paramètre d’une méthode qui a l’attribut [propget]. ) Le paramètre doit avoir l’attribut [out] et doit être un type pointeur.
Vous ne pouvez pas appliquer l’attribut [facultatif] à un paramètre [retval].
Le compilateur MIDL accepte le classement des paramètres suivant (de gauche à droite) :
- Paramètres obligatoires (paramètres qui n’ont pas les attributs [valeur_default] ou [facultatif] ).
- Paramètres facultatifs avec ou sans l’attribut [defaultvalue].
- Paramètres avec l’attribut [facultatif] et sans l’attribut [defaultvalue].
- [lcid] paramètre, le cas échéant.
- Paramètre [retval].
Les paramètres avec l’attribut [retval] ne sont pas affichés dans les navigateurs orientés utilisateur.
IDLFLAG_FRETVAL
HRESULT MyMethod([out, retval] InMyFace** ReturnVal);
HRESULT MyOtherMethod([out, retval] VARIANT_BOOL* ReturnVal);