Edit

Share via

ICOMAdminCatalog::InstallMultipleEventClasses method (comadmin.h)

  • Article

Installs event classes from multiple files into a COM+ application.

Syntax

HRESULT InstallMultipleEventClasses(
  [in] BSTR      bstrApplIdOrName,
  [in] SAFEARRAY **ppsaVarFileNames,
  [in] SAFEARRAY **ppsaVarCLSIDS
);

Parameters

[in] bstrApplIdOrName

The GUID or name of the application.

[in] ppsaVarFileNames

An array of the names of the DLL files that contains the event classes to be installed.

[in] ppsaVarCLSIDS

An array of CLSIDs for the event classes to be installed.

Return value

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

Remarks

Use InstallMultipleEventClasses to install event classes from DLLs 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