INF Directive AddComClass

  • Article

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"

Voir aussi