3.1.4.19 ICapabilitySupport

The ICapabilitySupport interface provides methods for starting and stopping optional, dynamically controllable, catalog-related capabilities of a COMA server. This version of COMA defines one such capability, instance load balancing (section 1.3.9). This interface inherits from IUnknown, as specified in [MS-DCOM] section 3.1.1.5.8.

To receive incoming remote calls for this interface, the server MUST implement a DCOM Object Class with the CLSID CLSID_COMAServer, specified in section 1.9, using the UUID {47CDE9A1-0BF6-11D2-8016-00C04FB9988E} for this interface.

This interface includes the following methods beyond those of IUnknown.

Methods in RPC Opnum Order

Method

Description

Start

Starts instance load balancing.

Opnum: 3

Stop

Stops instance load balancing.

Opnum: 4

Opnum5NotUsedOnWire

Reserved for local use.

Opnum: 5

Opnum6NotUsedOnWire

Reserved for local use.

Opnum: 6

IsInstalled

Determines whether instance load balancing support is installed.

Opnum: 7

IsRunning

Determines whether instance load balancing is running.

Opnum: 8

Opnum9NotUsedOnWire

Reserved for local use.

Opnum: 9

In the previous table, the phrase "Reserved for local use" means that the client MUST NOT send the opnum, and the server behavior is undefined since it does not affect interoperability.<348>

All methods MUST NOT throw exceptions.