NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Deploying and Configuring COM+ 1.0 Services

Before a managed class can acquire COM+1.0 services, you must load and register the assembly hosting the class; generate, register, and install the type library into an existing application; and configure each service. The RegSvcs utility reduces this effort by combining these activities into a single tool.

Syntax

RegSvcs assemblyName.dll applicationName [tblName.tbl]

This command-line utility requires a NGWS source assembly file and the name of the destination application in Component Services. If you plan to install your class into a new COM+ 1.0 application, create the application first before running the RegsSvcs utility. Optionally, you can specify a type library name or allow the utility to use the assembly name as the default.

The table below lists each step performed by the RegsSvcs utility and describes the failures that are possible at each step.

Step Possible failure
Loads the assembly If the assembly fails to load, the utility displays an error message and failure description.
Registers the assembly If the type registration fails, the utility displays the list of exceptions that were generated.

TypeLoadExceptions can result from an improperly specified COMEmulate attribute or assembly.

Generates a type library If the library generation fails, the utility provides a list of exceptions.

As with the previous step, an improperly specified COMEmulate attribute or assembly can result in TypeLoadExceptions.

Registers the type library The registration process uses the oleaut LoadTypeLibrary call and throws expected exceptions when it fails.
Installs the type library into the requested application If the utility cannot find the specified application, it will fail.

The error message, One of the objects could not be found, indicates that you should verify the presence of the specified type library and application.

Configures the class The utility will detect a service attribute mismatch and display an error.

For example, if you specify a transaction by setting the TransactionAttribute to Required and setting the SynchronizationAttribute to None, the utility will identify a conflict.

To obtain online help, enter regsvcs/? or regsvcs /h at the command line.