Using the COM Service Model Configuration Tool

Using the COM+ Service Model Configuration Tool

The mechanism used to configure COM+ interfaces to be exposed as Web services is the COM+ Service Model Configuration command-line tool (ComSvcConfig.exe). This tool will be used in this exercise to expose a COM+ business object.

The calling convention and command-line switches for ComSvcConfig are as shown here:

[View full width]
ComSvcConfig.exe /install | /list | /uninstall [/application:<ApplicationID  |ApplicationName>] [/contract<ClassID | ProgID | *,InterfaceID| InterfaceName | *>] [/ hosting:<complus | was>] [/webSite:<WebsiteName>] [/webDirectory:<WebDirectoryName>] [/mex]  [/id] [/nologo] [/verbose] [/help]

Note

You must be an administrator on the local computer to use ComSvcConfig.exe.

Table 6.1 describes the modes that can be used with ComSvcConfig.exe.

Table 6.1. Modes That Can Be Used with ComSvcConfig.exe

Option	Description
/install	Configures a COM+ interface for Service Model integration. Short form /i.
/uninstall	Removes a COM+ interface from Service Model integration. Short form /u.
/list	Queries for information about COM+ applications and components that have interfaces that are configured for Service Model integration. Short form /l.

Table 6.2 describes the options that can be used with ComSvcConfig.exe.

Table 6.2. Flags That Can Be Used with ComSvcConfig.exe

Option	Description
/application:< ApplicationID |	Specifies the COM+ application to configure.
ApplicationName >	Short form /a.
	Specifies the COM+ component and interface to configure as a service contract.
/contract:< ClassID | ProgID | *,	Short form /c.
InterfaceID | InterfaceName | * >	Although the wildcard character (*) can be used when you specify the component and interface names, we recommend that you do not use it, because you may expose interfaces you did not intend to.
	Specifies whether to use the COM+ hosting mode or the Short form /h.
/hosting:< complus | was > web hosting mode.	Using the COM+ hosting mode requires explicit activation of the COM+ application. Using the web hosting mode allows the COM+ application to be automatically activated as required. If the COM+ application is a library application, it runs in the Internet Information Services (IIS) process. If the COM+ application is a server application, it runs in the Dllhost.exe process.
/webSite:< WebsiteName >	Specifies the website for hosting when web hosting mode is used (see the /hosting flag).
	Short form /w.
	If no website is specified, the default website is used.
/webDirectory:< WebDirectoryName >	Specifies the virtual directory for hosting when web hosting is used (see the /hosting flag).
	Short form /d.
/mex	Adds a Metadata Exchange (MEX) service endpoint to the default service configuration to support clients that want to retrieve a contract definition from the service.
	Short form /x.
/id	Displays the application, component, and interface information as IDs.
	Short form /k.
/nologo	Prevents ComSvcConfig.exe from displaying its logo.
	Short form /n.
/verbose	Output additional tool progress information.
	Short form /v.
/help	Displays the usage message.
	Short form /?.