Diretiva INF AddComClass
Uma AddComClass é usada em uma com-server-install-section e registra uma classe COM. Um servidor COM deve definir uma ou mais classes. Esta seção é suportada para o Windows 11 versão 24H2 e posterior.
[com-server-install-section]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Entradas
clsid-guid
Especifica o valor GUID que identifica a classe COM. Use um valor GUID explícito do formulário {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} ou um token %strkey% definido para {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} em uma seção Strings do arquivo INF.
sinalizadores
Especifica sinalizadores extras para a diretiva AddComClass. Os sinalizadores são reservados para uso no futuro e devem ser deixado em branco ou definidos como zero.
com-class-install-section
Faz referência a uma seção INF-writer-defined que contém informações para registrar a classe COM. O campo com-class-install-section é opcional. Para mais informações, consulte a seção Comentários a seguir e, para mais informações sobre classes COM em geral, consulte Clientes e servidores COM.
Comentários
O código de instalação do sistema registra uma classe COM especificada por clsid-guid.
Cada diretiva AddComClass em uma seção de instalação do servidor COM do tipo INF-writer-defined pode fazer referência a uma com-class-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 AddComClass pode se referir a uma com-class-install-section nomeada em outro lugar no INF. Cada uma dessas seções tem a seguinte forma:
[com-class-install-section]
[Description = COM-class-description]
[ThreadingModel = threading-model-enum]
Descrição
Descrição é um valor opcional que descreve a classe COM.
ThreadingModel
O modelo de threading é opcional e define o que o servidor COM do modelo de threading suporta.
ThreadingModel | Descrição |
---|---|
Apartamento | Apartamento de thread simples |
Ambos | Apartamento com thread único ou múltiplo |
Gratuita | Apartamento com múltiplos threads |
Neutro | Apartamento neutro |
Observação
Se o modelo de threads não for especificado, o servidor será carregado no primeiro apartamento que foi inicializado no processo. Para mais informações, consulte InProcServer32.
Exemplo
[Device_Install.COM]
AddComServer = VendorComServer,, VendorComServer_Inst
[VendorComServer_Inst]
ServerType = 1 ; in-proc
ServerBinary = %13%\Vendor_ComServer.dll
AddComClass = {bb2b85ab-9473-42e5-8d1a-0f01d3879879}
AddComClass = {f1baf99b-d28a-4ea3-b652-355da082d260}, 0, Vendor_ComClass_WithThreadingModel_Inst
[Vendor_ComClass_WithThreadingModel_Inst]
Description = %Vendor_ComClass_Desc%
ThreadingModel = Both
[Strings]
%Vendor_ComClass_Desc%="Vendor COM class"