3.1.4.21 IContainerControl2

The IContainerControl2 interface provides methods for controlling InstanceContainers (section 2.2.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 {6C935649-30A6-4211-8687-C4C83E5FE1C7} for this interface.

This interface includes the following methods beyond those of IUnknown.

Methods in RPC Opnum Order

Method

Description

ShutdownContainer

Shuts down an instance container.

Opnum: 3

PauseContainer

Pauses an instance container.

Opnum: 4

ResumeContainer

Resumes a paused instance container.

Opnum: 5

IsContainerPaused

Determines whether an instance container is paused.

Opnum: 6

GetRunningContainers

Returns a list of running instance containers for a conglomeration.

Opnum: 7

GetContainerIDFromProcessID

Returns the instance container identifier corresponding to a process identifier.

Opnum: 8

RecycleContainer

Forces an instance container to be recycled.

Opnum: 9

GetContainerIDFromConglomerationID

Returns the instance container identifier of an instance container for a conglomeration.

Opnum: 10

All methods MUST NOT throw exceptions.