ICOMAdminCatalog::InstallEventClass method (comadmin.h)

Installs event classes from a file into a COM+ application.

Syntax

HRESULT InstallEventClass(
  [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 file name of the DLL containing the event classes to be installed.

[in] bstrTLB

The name of an 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 event class, 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

Use InstallEventClass to install event classes from a DLL holding dummy implementations of the event classes. The requirements are a self-registering DLL, a type library describing the interfaces implemented by the event classes, and each event class having a CLSID and a ProgID.

The dummy implementation of the interface exposed by an event class never actually runs; it exists only to register the event class. Instead, when the event class is created by the publisher, an implementation is provided by the Events system to send the event to subscribers.

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