Compartilhar via

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 tem suporte 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 a descrição da classe COM está ausente.

Sinalizadores

Especifica sinalizadores extras para a diretiva AddComServer. O campo sinalizadores é reservado para uso futuro e deve ser deixado em branco ou definido como zero.

com-server-install-section

Faz referência a uma seção definida pelo gravador INF que contém informações para registrar o servidor COM e suas classes.

Para obter 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.

Observações

A diretiva AddComServer faz com que a instalação do sistema registre um servidor COM implementado por um binário de servidor no caminho relativo do repositório de driver de um pacote de driver.

CoRegisterDeviceCatalog deve ser chamado em todos os processos antes de chamar CoCreateInstance na classe COM. Chamar CoRegisterDeviceCatalog disponibiliza os registros do servidor COM no processo para o runtime COM ser usado.

Cada diretiva AddComServer em uma seção DDInstall.COM INF pode fazer referência a uma seção com-server-install definida pelo gravador INF em outro lugar no arquivo INF. Cada nome de seção definido pelo gravador INF 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 seção com-server-install nomeada em outro lugar no INF. Cada seção desse tipo tem o seguinte formulário:

[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 uma ou mais AddComClass, cada uma 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 necessárias e opcionais. Somente 0x1 (In-proc) tem suporte.

server-type-enum Tipo de servidor Diretivas necessárias Diretivas opcionais
0x1 Em processo
  • ServerBinary
  • AddComClass
  • ServerBinaryWow64
  • ThreadingModel

ServerBinary

Caminho para o 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 obter mais informações sobre como registrar classes COM, consulte da Diretiva AddComClass do INF.

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"

Consulte também