ITDispatchMapper interface (tapi3if.h)

The ITDispatchMapper interface allows an application to retrieve the dispatch pointer of another interface on an object, given the dispatch pointer of one interface and the GUID of another. This interface is provided to assist programmers using scripting applications which do not automatically support tracking of multiple interfaces on an object.

The Dispatch Mapper will use the object's IObjectSafety interface to make sure the object is safe for scripting on the requested interface. If the object does not implement IObjectSafety, or if the object is not safe on this particular interface, the call will fail.

The Dispatch Mapper object must be created using COM CoCreateInstance.

Inheritance

The ITDispatchMapper interface inherits from the IDispatch interface. ITDispatchMapper also has these types of members:

Methods

The ITDispatchMapper interface has these methods.

 
ITDispatchMapper::QueryDispatchInterface

The QueryDispatchInterface method returns a dispatch pointer to a different interface on an object given its GUID and the dispatch pointer of another interface on the object.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)

See also

Dispatch Mapper

IDispatch