Diretiva INF AddComServer
Uma diretiva AddComServer é usada em uma seção DDInstall.COM e registra um servidor COM. Um ou mais servidores COM devem ser definidos em uma seção DDInstall.COM. Esta seção é suportada para o Windows 11 versão 24H2 e posterior.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
Entradas
com-server-name
Especifica o nome do servidor COM que está sendo instalado. O nome é geralmente o nome ou a descrição do componente COM que está sendo registrado. O nome do servidor COM deve ser exclusivo dentro do INF e é usado como a descrição quando não há descrição da classe COM.
sinalizadores
Especifica sinalizadores extras para a diretiva AddComServer. O campo de sinalizadores é reservado para uso no futuro e deve ser deixado em branco ou definido como zero.
com-server-install-section
Faz referência a uma seção INF-writer-defined que contém informações para registrar o servidor COM e suas classes.
Para mais informações sobre a seção de instalação do servidor COM, consulte as observações a seguir e, para servidores COM em geral, consulte Clientes e servidores COM.
Comentários
A diretiva AddComServer faz com que a configuração do sistema registre um servidor COM implementado por um binário de servidor no caminho relativo do armazenamento de driver de um pacote de driver.
CoRegisterDeviceCatalog deve ser chamado em todos os processos antes de chamar CoCreateInstance na classe COM. Chamar CoRegisterDeviceCatalog torna os registros do servidor COM disponíveis no processo para o runtime COM usar.
Cada diretiva AddComServer em uma seção INF DDInstall.COM pode fazer referência a uma seção com-server-install-section INF-writer-defined em outro lugar do arquivo INF. Cada nome de seção do tipo INF-writer-defined deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.
Uma diretiva AddComServer deve fazer referência a uma com-server-install-section nomeada em outro lugar no INF. Cada uma dessas seções tem a seguinte forma:
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Cada com-server-install-section deve fornecer ServerType, ServerBinary e um ou mais AddComClass, cada um em uma linha separada.
entradas e valores com-server-install-section
ServerType
Especifica o tipo de servidor COM que está sendo registrado. Cada tipo de servidor COM tem um conjunto específico de entradas e diretivas obrigatórias e opcionais. Somente 0x1 (In-proc) é suportado.
| server-type-enum | Tipo de servidor | Diretivas necessárias | Diretivas opcionais |
|---|---|---|---|
| 0x1 | Em processo |
|
|
ServerBinary
Caminho para binário do servidor COM para arquitetura nativa.
ServerBinaryWow64
Caminho para o binário WOW64 do servidor COM para suporte à arquitetura x86 não nativa na plataforma AMD64.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Essa diretiva necessária pode ser usada uma ou mais vezes para registrar classes COM com seções de instalação opcionais.
Para mais informações sobre como registrar classes COM, consulte Diretiva INF AddComClass.
Exemplo
[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"