Attributs d’interface
Les attributs suivants s’appliquent au mot clé C++ de l’interface (ou __interface).
| Attribut | Description |
|---|---|
| async_uuid | Spécifie l’UUID qui dirige le compilateur MIDL pour définir des versions synchrones et asynchrones d’une interface COM. |
| custom | Vous permet de définir vos propres attributs. |
| dispinterface | Place une interface dans le fichier .idl comme interface de dispatch. |
| dual | Place une interface dans le fichier .idl en tant qu’interface double. |
| export | Provoque l’emplacement d’une structure de données dans le fichier .idl. |
| helpcontext | Spécifie un ID de contexte qui permet à l’utilisateur d’afficher des informations sur cet élément dans le fichier d’aide. |
| helpfile | Définit le nom du fichier d’aide pour une bibliothèque de types. |
| helpstring | Spécifie une chaîne de caractères qui est utilisée pour décrire l’élément auquel elle s’applique. |
| helpstringcontext | Spécifie l’ID d’une rubrique d’aide dans un fichier .hlp ou .chm. |
| helpstringdll | Spécifie le nom de la DLL à utiliser pour effectuer la recherche de chaîne de document (localisation). |
| hidden | Indique que l’élément existe mais ne doit pas être affiché dans un navigateur orienté utilisateur. |
| library_block | Place une construction à l’intérieur du bloc de bibliothèque du fichier .idl. |
| local | Vous permet d’utiliser le compilateur MIDL comme générateur d’en-tête lorsqu’il est utilisé dans l’en-tête d’interface. Lorsqu’elle est utilisée dans une fonction individuelle, désigne une procédure locale pour laquelle aucun stub n’est généré. |
| nonextensible | Spécifie que l’implémentation IDispatch inclut uniquement les propriétés et méthodes répertoriées dans la description de l’interface et ne peut pas être étendue avec des membres supplémentaires au moment de l’exécution. Cet attribut n’est valide que sur une interface double . |
| odl | Identifie une interface en tant qu’interface ODL (Object Description Language). |
| object | Identifie une interface personnalisée. |
| oleautomation | Indique qu’une interface est compatible avec Automation. |
| pointer_default | Spécifie l’attribut de pointeur par défaut pour tous les pointeurs, à l’exception des pointeurs de niveau supérieur qui apparaissent dans les listes de paramètres. |
| ptr | Désigne un pointeur comme pointeur complet. |
| restricted | Désigne les membres de la bibliothèque qui ne peuvent pas être appelés arbitrairement. |
| uuid | Fournit l’ID unique de la bibliothèque |
Vous devez observer ces règles pour définir une interface :
La convention d’appel par défaut est __stdcall.
Un GUID est fourni pour vous si vous n’en fournissez pas un.
Aucune méthode surchargée n’est autorisée.
Lorsque vous ne spécifiez pas l’attribut uuid et que vous utilisez le même nom d’interface dans différents projets d’attributs, le même GUID est généré.