retval (atributo)
El atributo [retval] designa el parámetro que recibe el valor devuelto del miembro.
return-type function-name(
[out, retval [, optional-attributes]] data-type * param-name,
...);
Parámetros
-
return-type
-
Tipo de datos del valor devuelto del procedimiento remoto.
-
function-name
-
Nombre usado para invocar el procedimiento remoto.
-
atributos opcionales
-
Cero o más atributos MIDL.
-
tipo de datos
-
Tipo de los datos pasados por el parámetro .
-
param-name
-
Nombre del identificador del parámetro.
Comentarios
Puede usar el atributo [retval] en parámetros de miembros de interfaz que describen métodos u obtienen propiedades. (El atributo es necesario en el último parámetro de un método que tiene el atributo [propget] ). El parámetro debe tener el atributo [out] y debe ser un tipo de puntero.
No se puede aplicar el atributo [opcional] a un parámetro [retval].
El compilador MIDL acepta el siguiente orden de parámetros (de izquierda a derecha):
- Parámetros obligatorios (parámetros que no tienen los atributos [defaultvalue] o [opcional] ).
- Parámetros opcionales con o sin el atributo [defaultvalue].
- Parámetros con el atributo [opcional] y sin el atributo [defaultvalue].
- Parámetro [lcid], si existe.
- Parámetro [retval].
Los parámetros con el atributo [retval] no se muestran en exploradores orientados al usuario.
Marcas
IDLFLAG_FRETVAL
Ejemplos
HRESULT MyMethod([out, retval] InMyFace** ReturnVal);
HRESULT MyOtherMethod([out, retval] VARIANT_BOOL* ReturnVal);
Vea también