INF-AddComServer-Anweisung
Eine AddComServer-Anweisung wird in einem DDInstall.COM-Abschnitt verwendet und registriert einen COM-Server. Mindestens ein COM-Server muss in einem DDInstall.COM-Abschnitt definiert werden. Dieser Abschnitt wird ab Windows 11, Version 24H2 und höher unterstützt.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
Entries
com-server-name
Gibt den Namen des COM-Servers an, der installiert wird. Der Name ist in der Regel der Name oder die Beschreibung der com-Komponente, die registriert wird. Der COM-Servername muss innerhalb des INF-eindeutig sein und wird als Beschreibung verwendet, wenn die COM-Klassenbeschreibung fehlt.
flags
Gibt zusätzliche Flags für die AddComServer-Anweisung an. Das Flags-Feld ist für die zukünftige Verwendung reserviert und sollte leer bleiben oder auf Null festgelegt sein.
com-server-install-section
Verweist auf einen INF-Writer-definierten Abschnitt, der Informationen zum Registrieren des COM-Servers und seiner Klassen enthält.
Weitere Informationen zum Abschnitt „COM-Serverinstallation“ finden Sie in den folgenden Hinweisen und für COM-Server im Allgemeinen unter COM-Clients und -Server.
Hinweise
Die AddComServer-Anweisung bewirkt, dass das Systemsetup einen COM-Server registriert, der von einer Server-Binärdatei im relativen Pfad des Treiberspeichers eines Treiberpakets implementiert wird.
CoRegisterDeviceCatalog muss in jedem Prozess vor dem Aufrufen der CoCreateInstance für die COM-Klasse aufgerufen werden. Durch Aufrufen von CoRegisterDeviceCatalog werden die COM-Serverregistrierungen im Prozess für die zu verwendende COM-Laufzeit verfügbar.
Jede AddComServer-Anweisung in einem INF-DDInstall.COM-Abschnitt kann auf einen INF-writer-defined com-server-install-section an anderer 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 AddComServer-Anweisung muss auf einen benannten com-server-install-section an anderer Stelle in der INF-verweisen. Jeder dieser Abschnitte hat die folgende Form:
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Jeder com-server-install-section muss ServerType, ServerBinary und mindestens eine AddComClass jeweils in einer separaten Zeile bereitstellen.
com-server-install-section-Einträge und -Werte
ServerType
Gibt den Typ des COM-Servers an, der registriert wird. Jeder COM-Servertyp verfügt über einen bestimmten Satz von erforderlichen und optionalen Einträgen und Anweisungen. Es wird nur 0x1 (In-Proc) unterstützt.
| server-type-enum | Servertyp | Erforderliche Anweisungen | Optionale Anweisungen |
|---|---|---|---|
| 0x1 | Prozessintern |
|
|
ServerBinary
Pfad zur COM-Server-Binärdatei für systemeigene Architektur.
ServerBinaryWow64
Pfad zum COM-Server WOW64-Binary für nicht-native x86-Architekturunterstützung auf der AMD64-Plattform.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Diese erforderliche Anweisung kann mindestens ein Mal verwendet werden, um COM-Klassen mit optionalen Installationsabschnitten zu registrieren.
Weitere Informationen zum Registrieren von COM-Klassen finden Sie unter INF-AddComClass-Anweisung.
Beispiel
[ContosoEncoderServer.NT.COM]
AddComServer = ContosoEncoderServer,, ContosoEncoder_ComServer_Inst
[ContosoEncoder_ComServer_Inst]
ServerType = 1 ; in-proc
ServerBinary = %13%\contoso_encoder.dll
AddComClass = {bb2b85ab-9473-42e5-8d1a-0f01d3879879}
AddComClass = {f1baf99b-d28a-4ea3-b652-355da082d260}, 0, ContosoEncoderControl_ComClass_Inst
[ContosoEncoderControl_ComClass_Inst]
Description = %ContosoEncoder_Comclass_Desc%
ThreadingModel = Apartment
[Strings]
%ContosoEncoder_Comclass_Desc%="Contoso H.264 Encoder"