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) :

  1. Paramètres obligatoires (paramètres qui n’ont pas les [ attributs DefaultValue ] ou [ facultatifs ] )
  2. Paramètres facultatifs avec ou sans l' [ ] attribut DefaultValue,
  3. Paramètres avec l’attribut [ facultatif ] et sans l' [ attribut DefaultValue ] ,
  4. [ paramètre LCID ] , le cas échéant,
  5. [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)

Voir aussi

DefaultValue

Génération d’une bibliothèque de types avec MIDL

LCID

Exemple de fichier ODL

Syntaxe du fichier ODL

retval