Freigeben über

INF-AddComServer-Direktive

Eine AddComServer-Direktive 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 für Windows 11, Version 24H2 und höher, unterstützt.

[DDInstall.COM]

AddComServer = com-server-name, [flags], com-server-install-section

Einträge

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.

Flaggen

Gibt zusätzliche Flags für die AddComServer-Direktive 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.

Bemerkungen

Die AddComServer- Direktive bewirkt, dass das Systemsetup einen COM-Server registriert, der von einer Server-Binärdatei im Treiberspeicher des Treiberspeichersimplementiert wird.

CoRegisterDeviceCatalog- muss in jedem Prozess aufgerufen werden, bevor CoCreateInstance- für die COM-Klasse aufgerufen wird. Das Aufrufen CoRegisterDeviceCatalog stellt die COM-Serverregistrierungen im Prozess für die COM-Laufzeit zur Verfügung.

Jede AddComServer--Direktive 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--Direktive muss auf einen benannten com-server-install-section an anderer Stelle im INF verweisen. Jeder dieser Abschnitte weist das folgende Formular auf:

[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 ein oder mehrere AddComClass-bereitstellen, jeweils in einer separaten Zeile.

com-server-install-section entries and values

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 Direktiven. Nur 0x1 (In-Proc) wird unterstützt.

Servertyp-Enumeration Servertyp Erforderliche Direktiven Optionale Direktiven
0x1 Prozessintern
  • ServerBinary
  • AddComClass
  • ServerBinaryWow64
  • ThreadingModel

ServerBinary-

Pfad zur COM-Server-Binärdatei für systemeigene Architektur.

ServerBinaryWow64-

Pfad zum COM-Server WOW64 binary for non-native x86 architecture support on AMD64 platform.

AddComClass = {clsid-guid}[, flags[, com-class-install-section]]

Diese erforderliche Direktive 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 Directive.

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"

Siehe auch