Compartilhar via


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"

Confira também