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