Direttiva INF AddComServer
Una direttiva AddComServer viene usata all'interno di una sezione DDInstall.COM e registra un server COM. Uno o più server COM devono essere definiti in una sezione DDInstall.COM. Questa sezione è supportata per Windows 11 versione 24H2 e successive.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
whse.
com-server-name
Specifica il nome del server COM in fase di installazione. Il nome è in genere il nome o la descrizione del componente COM registrato. Il nome del server COM deve essere univoco all'interno di INF e viene usato come descrizione quando manca la descrizione della classe COM.
flags
Specifica flag aggiuntivi per la direttiva AddComServer. Il campo flags è riservato per uso futuro e deve essere lasciato vuoto o impostato su zero.
com-server-install-section
Fa riferimento a una sezione definita dal writer INF che contiene informazioni per la registrazione del server COM e delle relative classi.
Per altre informazioni sulla sezione relativa all'installazione del server COM, vedere le osservazioni seguenti e per i server COM in generale, vedere Client e server COM.
Osservazioni:
La direttiva AddComServer determina la registrazione di un server COM implementato da un file binario del server nel percorso relativo dell'archivio driver di un pacchetto driver.
È necessario chiamare CoRegisterDeviceCatalog in ogni processo prima di chiamare CoCreateInstance nella classe COM. La chiamata a CoRegisterDeviceCatalog rende disponibili le registrazioni del server COM nel processo per l'uso del runtime COM.
Ogni direttiva AddComServer in una sezione DDInstall.COM INF può fare riferimento a una sezione INF-writer-defined com-server-install-section altrove nel file INF. Ogni nome di sezione definito dal writer INF deve essere univoco all'interno del file INF e deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.
Una direttiva AddComServer deve fare riferimento a una sezione com-server-install-section denominata altrove in INF. Ogni sezione di questo tipo ha il formato seguente:
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Ogni sezione com-server-install-deve specificare ServerType, ServerBinary e uno o più AddComClass, ognuno in una riga separata.
voci e valori com-server-install-section
Servertype
Specifica il tipo di server COM registrato. Ogni tipo di server COM ha un set specifico di voci e direttive obbligatorie e facoltative. È supportato solo 0x1 (In-proc).
| enumerazione server-type-enum | Tipo di server | Direttive obbligatorie | Direttive facoltative |
|---|---|---|---|
| 0x1 | In-process |
|
|
ServerBinary
Percorso del file binario del server COM per l'architettura nativa.
ServerBinaryWow64
Percorso del file binario WOW64 del server COM per il supporto dell'architettura x86 non nativa nella piattaforma AMD64.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Questa direttiva obbligatoria può essere usata una o più volte per registrare classi COM con sezioni di installazione facoltative.
Per altre informazioni su come registrare classi COM, vedere Direttiva INF AddComClass.
Esempio
[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"