Edit

Share via

INF AddComClass directive

  • Article

An AddComClass is used within a com-server-install-section and registers a COM class. A COM server must define one or more classes. This section is supported for Windows 11 version 24H2 and later.

[com-server-install-section]

AddComClass = {clsid-guid}[, flags[, com-class-install-section]]

Entries

clsid-guid

Specifies the GUID value that identifies the COM class. Use an explicit GUID value of the form {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} or a %strkey% token defined to {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} in a Strings section of the INF file.

flags

Specifies extra flags for the AddComClass directive. The flags are reserved for future use and should be left blank or set to zero.

com-class-install-section

References an INF-writer-defined section that contains information for registering the COM class. The com-class-install-section field is optional. For more information, see the following Remarks section, and for more information on COM classes in general, see COM Clients and Servers.

Remarks

The system setup code registers a COM class specified by clsid-guid.

Each AddComClass directive in an INF-writer-defined COM server install section can reference an INF-writer-defined com-class-install-section elsewhere in the INF file. Each INF-writer-defined section name must be unique within the INF file and must follow the general rules for defining section names. For more information about these rules, see General Syntax Rules for INF Files.

An AddComClass directive can refer to a named com-class-install-section elsewhere in the INF. Each such section has the following form:

[com-class-install-section]

[Description    = COM-class-description]
[ThreadingModel = threading-model-enum]

Description

Description is an optional value describing the COM class.

ThreadingModel

Threading model is optional and defines what threading model COM server supports.

ThreadingModel Description
Apartment Single-threaded apartment
Both Single-threaded or multithreaded apartment
Free Multithreaded apartment
Neutral Neutral apartment

Note

If threading model is not specified, the server is loaded into the first apartment that was initialized in the process. For more information, see InProcServer32.

Example

[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"

See also