Edit

Share via

ICOMAdminCatalog::InstallComponent method (comadmin.h)

  • Article

Installs all components (COM classes) from a DLL file into a COM+ application and registers the components in the COM+ class registration database.

Syntax

HRESULT InstallComponent(
  [in] BSTR bstrApplIDOrName,
  [in] BSTR bstrDLL,
  [in] BSTR bstrTLB,
  [in] BSTR bstrPSDLL
);

Parameters

[in] bstrApplIDOrName

The GUID or name of the application.

[in] bstrDLL

The name of the DLL file containing the component to be installed.

[in] bstrTLB

The name of the external type library file. If the type library file is embedded in the DLL, pass in an empty string for this parameter.

[in] bstrPSDLL

The name of the proxy-stub DLL file. If there is no proxy-stub DLL associated with the component, pass in an empty string for this parameter.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Remarks

InstallComponent provides full registration of components in the COM+ class registration database (RegDB) as configured components, including interface, method, type library, and proxy-stub information necessary for marshaling.

InstallComponent is the recommended way to install all components into COM+ applications instead of ICOMAdminCatalog::ImportComponent.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comadmin.h

See also

ICOMAdminCatalog