optional (attribut)
L’attribut [ facultatif ] spécifie un paramètre facultatif pour une fonction membre.
return-type function-name([optional [, other-attributes]] parameter-type parameter-name)
Paramètres
-
type de retour
-
Spécifie le type de retour de la fonction.
-
nom de fonction
-
Spécifie le nom de la fonction tel qu’il est défini dans le fichier IDL.
-
autres attributs
-
Zéro, un ou plusieurs attributs MIDL facultatifs.
-
type de paramètre
-
Type de données du paramètre facultatif.
-
nom du paramètre
-
Spécifie le nom du paramètre facultatif.
Notes
L’attribut [ facultatif ] est valide uniquement si le paramètre est de type Variant ou Variant * .
Le compilateur MIDL accepte l’ordonnancement des paramètres suivant (de gauche à droite) :
- Paramètres obligatoires (paramètres qui n’ont pas les [ attributs DefaultValue ] ou [ facultatifs ] )
- Paramètres facultatifs avec ou sans l' [ ] attribut DefaultValue,
- Paramètres avec l’attribut [ facultatif ] et sans l' [ attribut DefaultValue ] ,
- [ paramètre LCID ] , le cas échéant,
- [retVal ] paramètre
Vous ne pouvez pas appliquer l’attribut [ facultatif ] à un paramètre qui possède également les [ ] attributs LCID ou [ retVal ] .
Exemples
HRESULT MyFunc([in, optional] VARIANT Param1,
[out, optional] VARIANT Param2)