3.1.4.1 IGetTrackingData

The IGetTrackingData interface provides methods for a client to poll for tracking information. This interface inherits from IUnknown, as specified in [MS-DCOM] section 3.1.1.5.8. The version for this interface is 0.0.

To receive incoming remote calls for this interface, the server MUST implement a DCOM object class with the CLSID CLSID_TrackerService (as specified in section 1.9) by using the UUID {B60040E0-BCF3-11D1-861D-0080C729264D} for this interface.

The IGetTrackingData interface includes the following methods beyond those of IUnknown.

Methods in RPC Opnum Order

Method

Description

Opnum3NotUsedOnWire

Reserved for local use.

Opnum: 3

GetContainerData

Returns tracking information for instance containers.

Opnum: 4

GetComponentDataByContainer

Returns tracking information for components by instance container.

Opnum: 5

GetComponentDataByContainerAndCLSID

Returns tracking information for a component by instance container and CLSID.

Opnum: 6

Opnum7NotUsedOnWire

Reserved for local use.

Opnum: 7

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

All methods MUST NOT throw exceptions.