Partager via


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é.

Voir aussi

Attributs par utilisation