3.1.4.11 IRegister2

  • Article

The IRegister2 interface provides methods for registration, as specified in section 1.3.6, and creating component configurations. 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, as specified in section 1.9, using the UUID {971668DC-C3FE-4EA1-9643-0C7230F494A1} for this interface.

This interface includes the following methods beyond those of IUnknown.

Methods in RPC Opnum Order

Method

Description

CreateFullConfiguration

Creates a component full configuration for an existing component.

Opnum: 3

CreateLegacyConfiguration

Creates a component legacy configuration for an existing component.

Opnum: 4

PromoteLegacyConfiguration

Converts a component legacy configuration into a component full configuration.

Opnum: 5

Opnum6NotUsedOnWire

Reserved for local use.

Opnum: 6

Opnum7NotUsedOnWire

Reserved for local use.

Opnum: 7

RegisterModule2

Registers the components in one or more modules.

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.<324>

All methods MUST NOT throw exceptions.