DCOM Server

A DCOM Server object represents a DCOM server registration or unregistration. It is used to specify the configuration options of one or more distributed COM classes that are hosted by a single executable. The applicable COM classes refer back to the DCOM server through their AppID attribute. Registration or unregistration of a DCOM server is controlled by its component and any COM classes that specify its AppID.

Situation InstallMate
Not linked to a component The DCOM server is registered if at least one COM Class with its AppID is registered.
Linked to a component The DCOM server is registered if its component is installed.

InstallMate allows you to register a DCOM server either implicitly, if one of its dependents is registered, or explicitly, for example if it doesn't have any dependents. See COM classes for more information.


The following attributes and options are available.

Attribute Description
AppID Enter the GUID (Globally Unique IDentifier) of the DCOM server the distributed COM classes.
Display name Enter the user-visible name of the DCOM server.
DLL surrogate Enter the file name or full path to the executable that provides the surrogate process for a DLL-based DCOM server, or leave blank for a system-supplied surrogate executable (if required).
Surrogate .exe

Name of the DLL surrogate process, used for disambiguation of the surrogate process name specified by DLL surrogate.

This option only has effect on Windows Server 2003 and later, and is used as the first parameter (lpApplicationName) of the CreateProcess function call that the DCOM subsystem uses internally to start the DLL surrogate proces that you specify through DLL surrogate.

Local service Enter the name of the service if the distributed COM class is implemented and installed as a service rather than (or in addition to) a regular executable program, or leave empty for a non-service implementation.

Enter any start-up parameters for the Local service service; these will be used when the service is started by the DCOM subsystem.

Remote server Enter the name of the network server on which the COM class objects must run if no COSERVERINFO information is specified during object activation, or leave empty for no preference.

Enter the TCP port number(s) to be used by the DCOM server for communication, or leave empty to let the DCOM subsystem assign port numbers dynamically.

The Endpoints field must use the following format:


where port is the TCP port number to use between 1024 and 65535.

Activate at storage Check this box to instantiate COM objects on the same machine as the persistent state from which they are initialized; clear it not to force this behavior.

Select the required authentixation level from the drop-down list. The following choices are available:

Authentication Description
Default Use default authentication level for the protocol.
None Do not perform any authentication.
Connect Authenticate when the client connects to the server.
Call Authenticate at the beginning of each RPC call. For connection-oriented protocols (including all DCOM communication except NT4-to-NT4 DCOM), Packet authentication is used instead.
Packet Authenticate each data packet.
Packet Integrity Authenticate each data packet and verify the data integrity of each packet.
Packet Privacy As Packet Integrity, but in addition use a secure channel or encryption to protect the packet data from eavesdroppers.
Trust level

Select the desired trust level for the DCOM server. This option only has effect on Windows XP and later. The following choices are available:

Trust level Description
Disallowed Do not allow access to security-sensitive user privileges.
Unrestricted Allow unrestricted access to security-sensitive user privileges.
Run As

Enter the user account name under which the COM class must run when activated; leave empty to use the default DCOM user account. The Run As name must have one of the following formats:

Run As Description
(empty) Use the default DCOM user account.
username Run under the local username account.
domain\username Run under the domain\username account.
Interactive User Run under the identity of the currently logged-in interactive user.
NT Authority\LocalService [Windows Server 2003] Run under the Local Service account.
NT Authority\NetworkService [Windows Server 2003] Run under the Network Service account.
NT Authority\System [Windows Server 2003] Run under the Local System account.

Related topics

COM classes, Working with attribute panes