INF AddComClass-Anweisung
Eine AddComClass wird in einem com-server-install-section verwendet und registriert eine COM-Klasse. Ein COM-Server muss eine oder mehrere Klassen definieren. Dieser Abschnitt wird ab Windows 11, Version 24H2 und höher unterstützt.
[com-server-install-section]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Entries
clsid-guid
Gibt den GUID-Wert an, der die COM-Klasse identifiziert. Verwenden Sie einen expliziten GUID-Wert des Formulars {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} oder %strkey%-Token, das mit {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} in einem Strings-Abschnitt der INF-Datei definiert ist.
flags
Gibt zusätzliche Flags für die AddComClass-Anweisung an. Die Flags sind für die zukünftige Verwendung reserviert und sollten leer bleiben oder auf Null festgelegt sein.
com-class-install-section
Verweist auf einen INF-Writer-definierten Abschnitt, der Informationen zum Registrieren der COM-Klasse enthält. Das Feld com-class-install-section ist optional. Weitere Informationen finden Sie im folgenden Abschnitt „Hinweise“ und Informationen zu COM-Klassen im Allgemeinen unter COM-Clients und -Server.
Hinweise
Der Systemsetupcode registriert eine COM-Klasse, die durch clsid-guid angegeben wird.
Jede AddComClass-Anweisung in einem INF-writer-defined COM-Serverinstallationsabschnitt kann auf einen INF-writer-defined com-class-install-section an einer anderen Stelle in der INF-Datei verweisen. Jeder INF-Writer-definierte Abschnittsname muss innerhalb der INF-Datei eindeutig sein und muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Eine AddComClass-Anweisung kann auf einen benannten Com-Klasseninstallationsabschnitt an einer anderen Stelle im INF verweisen. Jeder dieser Abschnitte hat die folgende Form:
[com-class-install-section]
[Description = COM-class-description]
[ThreadingModel = threading-model-enum]
Beschreibung
Die Beschreibung ist ein optionaler Wert, der die COM-Klasse beschreibt.
ThreadingModel
Das Threadingmodell ist optional und definiert, welche Threadingmodelle der COM-Server unterstützt.
| ThreadingModel | Beschreibung |
|---|---|
| Apartment | Singlethread-Apartment |
| Beides | Singlethread- oder Multithread-Apartment |
| Kostenlos | Multithread-Apartment |
| Neutral | Neutral-Apartment |
Hinweis
Wenn das Threadingmodell nicht angegeben ist, wird der Server in das erste Apartment geladen, das im Prozess initialisiert wurde. Weitere Informationen finden Sie unter InProcServer32.
Beispiel
[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"