Utilisation de dllimport et dllexport dans les classes C++

  • Article

Section spécifique à Microsoft

Vous pouvez déclarer des classes C++ avec l’attribut ou dllexport l’attributdllimport. Ces formes impliquent que toute la classe soit importée ou exportée. Les classes exportées de cette façon sont appelées des classes exportables.

L'exemple suivant définit une classe exportable. Toutes ses fonctions membres et données statiques sont exportées :

#define DllExport   __declspec( dllexport )

class DllExport C {
   int i;
   virtual int func( void ) { return 1; }
};

Notez que l’utilisation dllimport explicite des attributs et dllexport des membres d’une classe exportable est interdite.

dllexport, classes

Lorsque vous déclarez une classe dllexport, toutes ses fonctions membres et ses membres de données statiques sont exportés. Vous devez fournir les définitions de tous ces membres dans le même programme. Sinon, une erreur d'éditeur de liens est générée. La seule exception à cette règle s'applique aux fonctions virtuelles pures, pour lesquelles vous n'avez pas besoin de fournir de définitions explicites. Toutefois, étant donné qu'un destructeur d'une classe abstraite est toujours appelé par le destructeur de la classe de base, les destructeurs virtuels purs doivent toujours fournir une définition. Notez que ces règles sont identiques pour les classes non exportables.

Si vous exportez des données de classe de type ou des fonctions qui retournent des classes, veillez à exporter la classe.

dllimport, classes

Lorsque vous déclarez une classe dllimport, toutes ses fonctions membres et ses membres de données statiques sont importés. Contrairement au comportement des dllimport types nonclasses, dllexport les membres de données statiques ne peuvent pas spécifier une définition dans le même programme dans lequel une dllimport classe est définie.

Classes d’héritage et exportables

Toutes les classes de base d'une classe exportable doivent être exportées. Sinon, un avertissement du compilateur est généré. De plus, tous les membres accessibles qui sont également des classes doivent être exportables. Cette règle permet à une dllexport classe d’hériter d’une dllimport classe et d’une dllimport classe d’hériter d’une dllexport classe (bien que cette dernière ne soit pas recommandée). En règle générale, tout ce qui est accessible au client de la DLL (conformément aux règles d'accès C++) doit faire partie de l'interface exportable. Cela inclut les données membres privées référencées dans les fonctions inline.

Importation/exportation de membres sélectifs

Étant donné que les fonctions membres et les données statiques d’une classe ont implicitement une liaison externe, vous pouvez les déclarer avec l’attribut ou dllexport l’attributdllimport, sauf si la classe entière est exportée. Si l’ensemble de la classe est importé ou exporté, la déclaration explicite des fonctions membres et des données comme dllimport ou dllexport est interdite. Si vous déclarez un membre de données statique dans une définition de classe en tant que dllexport, une définition doit se produire quelque part dans le même programme (comme avec la liaison externe non classe).

De même, vous pouvez déclarer des fonctions membres avec les attributs ou dllexport les dllimport attributs. Dans ce cas, vous devez fournir une dllexport définition quelque part dans le même programme.

Il est intéressant de noter plusieurs aspects importants concernant l'importation et l'exportation de membres sélectifs :

  • L'importation/exportation de membres sélectifs permet principalement de fournir une version de l'interface de classe exportée qui est plus restrictive ; autrement dit, une version pour laquelle vous pouvez concevoir une DLL qui expose moins de fonctionnalités publiques et privées que ne le permet le langage. Cela permet également d'affiner l'interface exportable : lorsque vous savez que le client, par définition, ne peut pas accéder à certaines données privées, vous n'avez pas besoin d'exporter la classe entière.

  • Si vous exportez une seule fonction virtuelle d'une classe, vous devez toutes les exporter ou fournir au moins les versions que le client peut utiliser directement.

  • Si vous avez une classe dans laquelle vous utilisez l'importation/exportation de membres sélectifs avec des fonctions virtuelles, les fonctions doivent être dans l'interface exportable ou définies inline (visibles par le client).

  • Si vous définissez un membre comme dllexport mais que vous ne l’incluez pas dans la définition de classe, une erreur du compilateur est générée. Vous devez définir le membre dans l'en-tête de classe.

  • Bien que la définition des membres de classe comme ou dllexport soit dllimport autorisée, vous ne pouvez pas remplacer l’interface spécifiée dans la définition de classe.

  • Si vous définissez une fonction membre dans un endroit autre que le corps de la définition de classe dans laquelle vous l’avez déclarée, un avertissement est généré si la fonction est définie comme dllexport ou dllimport (si cette définition diffère de celle spécifiée dans la déclaration de classe).

FIN de la section spécifique à Microsoft

Voir aussi

dllexport, dllimport