Class element
COM Class registration for parent Component.
Windows Installer references
Class Table, ProgId Table, Registry Table, AppId Table
Parents
File, TypeLib, AppId, Component
Children
- FileTypeMask
- Interface
- ProgId : A ProgId associated with Class must be a child element of the Class element
Remarks
When being used in unadvertised mode, the attributes in the Class element correspond to registry
values under the [HKCR\CLSID\{'{'}Id{'}'}] and [HKCR\CLSID\{'{'}Id{'}'}\Context] keys as follows:
Id, Context: [HKCR\CLSID{'{'}Id{'}'}\Context]Server: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="[!comserv.dll]"ForeignServer: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="mscoree.dll"AppId: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}]\AppId="{00000000-89AB-0000-0123-000000000000}"Argument: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="[!comserv.dll] /arg1 /arg2 /arg3"Control: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\Control]Description: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}]\@="Description of Example COM Component"Handler: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\InprocHandler32]\@="handler.dll"Insertable: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\Insertable]Insertable: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\NotInsertable]Programmable: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\Programmable]SafeForInitializing: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\Implemented Categories{7DD95801-9882-11CF-9FA9-00AA006C42C4}]ThreadingModel: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\ThreadingModel="Apartment"TypeLibId: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\TypeLib]\@="{11111111-89AB-1111-0123-111111111111}"Version: [HKCR\CLSID{01234567-89AB-CDEF-0123-456789ABCDEF}\Version]\@="1.0.0.0"
Attributes
Advertise (YesNoTypeUnion) : Set this value to "yes" in order to create a normal Class table row. Set this value to "no" in order to generate Registry rows that perform similar registration (without the often problematic Windows Installer advertising behavior).
AppId (Guid) : This attribute is only allowed when a Class is advertised. Using this attribute will reference an Application ID containing DCOM information for the associated application GUID. The value must correspond to an AppId/@Id of an AppId element nested under a Fragment, Module, or Package element. To associate an AppId with a non-advertised class, nest the class within a parent AppId element.
Argument (String) : This column is optional only when the Context column is set to "LocalServer" or "LocalServer32" server context. The text is registered as the argument against the OLE server and is used by OLE for invoking the server. Note that the resolution of properties in the Argument field is limited. A property formatted as [Property] in this field can only be resolved if the property already has the intended value when the component owning the class is installed. For example, for the argument "[#MyDoc.doc]" to resolve to the correct value, the same process must be installing the file MyDoc.doc and the component that owns the class.
Context () : The server context(s) for this COM server. This attribute is optional for VB6 libraries that are marked "PublicNotCreateable". Class elements marked Advertised must specify at least one server context. It is most common for there to be a single value for the Context attribute.
Control (YesNoTypeUnion) : Set this attribute's value to 'yes' to identify an object as an ActiveX Control. The default value is 'no'.
Description (String) : Localized description associated with the Class ID and Program ID.
ForeignServer (String) : May only be specified if the value of the Advertise attribute is "no" and Server has not been specified. In addition, it may only be used when the Class element is directly under the Component element. The value can be that of an registry type (REG_SZ). This attribute should be used to specify foreign servers, such as mscoree.dll if needed.
Handler (String) : The default inproc handler. May be optionally provided only for Context = LocalServer or LocalServer32. Value of "1" creates a 16-bit InprocHandler (appearing as the InprocHandler value). Value of "2" creates a 32-bit InprocHandler (appearing as the InprocHandler32 value). Value of "3" creates 16-bit as well as 32-bit InprocHandlers. A non-numeric value is treated as a system file that serves as the 32-bit InprocHandler (appearing as the InprocHandler32 value).
Icon (String) : The file providing the icon associated with this CLSID. Reference to an Icon element (should match the Id attribute of an Icon element). This is currently not supported if the value of the Advertise attribute is "no".
IconIndex (Integer) : Icon index into the icon file.
Id (Guid, required) : The Class identifier (CLSID) of a COM server.
Insertable (YesNoTypeUnion) : Specifies the CLSID may be insertable.
Programmable (YesNoTypeUnion) : Specifies the CLSID may be programmable.
RelativePath (YesNoTypeUnion) : When the value is "yes", the bare file name can be used for COM servers. The installer registers the file name only instead of the complete path. This enables the server in the current directory to take precedence and allows multiple copies of the same component.
SafeForInitializing (YesNoTypeUnion) : May only be specified if the value of the Advertise attribute is "no".
SafeForScripting (YesNoTypeUnion) : May only be specified if the value of the Advertise attribute is "no".
Server (String) : May only be specified if the value of the Advertise attribute is "no" and the ForeignServer attribute is not specified. File Id of the COM server file. If this element is nested under a File element, this value defaults to the value of the parent File/@Id.
ShortPath (YesNoTypeUnion) : Specifies whether or not to use the short path for the COM server. This can only apply when Advertise is set to 'no'. The default is 'no' meaning that it will use the long file name for the COM server.
ThreadingModel (enumeration) : Threading model for the CLSID. This attribute's value must be one of the following:
- apartment
- free
- both
- neutral
- single
- rental
Version (String) : Version for the CLSID.