WiX Toolset

AppId Element

Description
Application ID containing DCOM information for the associated application GUID. If this element is nested under a Fragment, Module, or Product element, it must be advertised.
Windows Installer references
AppId Table, Registry Table
Parents
Component, File, Fragment, Module, Product, TypeLib
Inner Text
None
Children
Choice of elements (min: 0, max: unbounded)
  • Class (min: 0, max: unbounded)
Attributes
Name Type Description Required
Id Guid Set this value to the AppID GUID that corresponds to the named executable. Yes
ActivateAtStorage YesNoType Set this value to 'yes' to configure the client to activate on the same system as persistent storage.  
Advertise YesNoType Set this value to 'yes' in order to create a normal AppId 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).  
Description String Set this value to the description of the AppId. It can only be specified when the AppId is not being advertised.  
DllSurrogate String Set this value to specify that the class is a DLL that is to be activated in a surrogate EXE process, and the surrogate process to be used is the path of a surrogate EXE file specified by the value.  
LocalService String Set this value to the name of a service to allow the object to be installed as a Win32 service.  
RemoteServerName String Set this value to the name of the remote server to configure the client to request the object be run at a particular machine whenever an activation function is called for which a COSERVERINFO structure is not specified.  
RunAsInteractiveUser YesNoType Set this value to 'yes' to configure a class to run under the identity of the user currently logged on and connected to the interactive desktop when activated by a remote client without being written as a Win32 service.  
ServiceParameters String Set this value to the parameters to be passed to a LocalService on invocation.  
Remarks
When being used in unadvertised mode, the attributes in the AppId element correspond to registry keys as follows (values that can be specified in authoring are in bold):
Id
In General
[HKCR\AppID\{Id}]
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
ActivateAtStorage
In General
[HKCR\AppID\{Id}]
ActivateAtStorage="ActivateAtStorage"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
ActivateAtStorage="Y"
Description
In General
[HKCR\AppID\{Id}]
@="Description"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
@="My AppId Description"
DllSurrogate
In General
[HKCR\AppID\{Id}]
DllSurrogate="DllSurrogate"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
DllSurrogate="C:\surrogate.exe"
LocalService
In General
[HKCR\AppID\{Id}]
LocalService="LocalService"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
LocalService="MyServiceName"
RemoteServerName
In General
[HKCR\AppID\{Id}]
RemoteServerName="RemoteServerName"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
RemoteServerName="MyRemoteServer"
RunAsInteractiveUser
In General
[HKCR\AppID\{Id}]
RunAs="RunAsInteractiveUser"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
RunAs="Interactive User"
ServiceParameters
In General
[HKCR\AppID\{Id}]
ServiceParameters="ServiceParameters"
Specific Example
[HKCR\AppID\{01234567-89AB-CDEF-0123-456789ABCDEF}]
ServiceParameters="-param"
See Also
Wix Schema