INF Directive AddComClass
Une directive AddComClass est utilisée dans une section com-server-install et enregistre une classe COM. Un serveur COM doit définir une ou plusieurs classes. Cette section est prise en charge pour Windows 11 version 24H2 et ultérieures.
[com-server-install-section]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Entries
clsid-guid
Spécifie la valeur GUID qui identifie la classe COM. Utilisez une valeur GUID explicite de la forme {nnnnnnnn-nnnn-nnnn-nnnnnnnn} ou un jeton %strkey% défini comme {nnnnnnnn-nnnnnnnnnnn} dans une section Strings du fichier INF.
flags
Spécifie des indicateurs supplémentaires pour la directive AddComClass. Ces indicateurs sont réservés pour une utilisation future et doivent être laissés vides ou mis à zéro.
com-class-install-section
Fait référence à une section définie par le rédacteur INF qui contient des informations sur l'enregistrement de la classe COM. Le champ com-class-install-section est facultatif. Pour plus d'informations, reportez-vous à la section Remarques suivante et, pour plus d'informations sur les classes COM en général, reportez-vous à la section Clients et serveurs COM.
Notes
Le code d'installation du système enregistre une classe COM spécifiée par clsid-guid.
Chaque directive AddComClass d'une section d'installation de serveur COM définie par un rédacteur INF peut faire référence à une section d'installation de classe COM définie par un rédacteur INF située ailleurs dans le fichier INF. Chaque nom de section défini par le rédacteur INF doit être unique dans le fichier INF et doit respecter les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
Une directive AddComClass peut faire référence à une section com-class-install nommée ailleurs dans le fichier INF. Chacune de ces sections a la forme suivante :
[com-class-install-section]
[Description = COM-class-description]
[ThreadingModel = threading-model-enum]
Description
Description est une valeur facultative décrivant la classe COM.
ThreadingModel
Threading model est facultatif et définit le modèle de threading pris en charge par le serveur COM.
| ThreadingModel | Description |
|---|---|
| Appartement | Single-threaded (appartement à un seul thread) |
| Les deux | Appartement à threading unique ou multithreading |
| Gratuit | Appartement multithreadé |
| Neutre | Appartement neutre |
Remarque
Si le modèle de threading n'est pas spécifié, le serveur est chargé dans le premier appartement initialisé dans le processus. Pour plus d'informations, voir InProcServer32.
Exemple
[Device_Install.COM]
AddComServer = VendorComServer,, VendorComServer_Inst
[VendorComServer_Inst]
ServerType = 1 ; in-proc
ServerBinary = %13%\Vendor_ComServer.dll
AddComClass = {bb2b85ab-9473-42e5-8d1a-0f01d3879879}
AddComClass = {f1baf99b-d28a-4ea3-b652-355da082d260}, 0, Vendor_ComClass_WithThreadingModel_Inst
[Vendor_ComClass_WithThreadingModel_Inst]
Description = %Vendor_ComClass_Desc%
ThreadingModel = Both
[Strings]
%Vendor_ComClass_Desc%="Vendor COM class"