Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Uma diretiva AddComServer é usada dentro de 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 secção é suportada para o Windows 11 versão 24H2 e posterior.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
Inscrições
com-nome-do-servidor
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.
bandeiras
Especifica sinalizadores extras para a diretiva AddComServer. O campo de 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 seguintes observações e, para servidores COM em geral, consulte Clientes e servidores COM.
Observações
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 de 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 disponibiliza os registros do servidor COM no processo para o tempo de execução do COM usar.
Cada diretiva AddComServer em uma seção de DDInstall.COM INF pode fazer referência a uma com-server-install-section 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 obter 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 nomeada com-server-install-section em outro lugar no INF. Cada secção 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. Apenas 0x1 (In-proc) é suportado.
| servidor-tipo-enum | Tipo de servidor | Diretivas necessárias | Diretivas facultativas |
|---|---|---|---|
| 0x1 | No proc |
|
|
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]]
Esta 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 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"