3.1.4.5 ICatalogSession

  • Article

The ICatalogSession interface provides methods for Catalog Version Negotiation (section 3.1.4.1) and for Multiple-partition Support Capability Negotiation (section 3.1.4.3). 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 (see section 1.9) using the UUID {182C40FA-32E4-11D0-818B-00A0C9231C29} for this interface.

Besides the methods of IUnknown, this interface includes the following methods.

Methods in RPC Opnum Order

Method

Description

Opnum3NotUsedOnWire

Reserved for local use.

Opnum: 3

Opnum4NotUsedOnWire

Reserved for local use.

Opnum: 4

Opnum5NotUsedOnWire

Reserved for local use.

Opnum: 5

Opnum6NotUsedOnWire

Reserved for local use.

Opnum: 6

InitializeSession

Performs catalog version negotiation.

Opnum: 7

GetServerInformation

Performs capability negotiation for the multiple-partition support capability.

Opnum: 8

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 because it does not affect interoperability.<284>

All methods MUST NOT throw exceptions.