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:

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.


Figure describes the modes that can be used with ComSvcConfig.exe.

Figure 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.


Figure describes the options that can be used with ComSvcConfig.exe.

Figure 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 /?.




 Python   SQL   Java   php   Perl 
 game development   web development   internet   *nix   graphics   hardware 
 telecommunications   C++ 
 Flash   Active Directory   Windows