| Platform SDK: TAPI |
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.
IDispatch Methods
| ITDispatchMapper methods | Description |
|---|---|
| QueryDispatchInterface | Returns a dispatch pointer to a different interface on an object given its GUID and the dispatch pointer of another interface on the object. |
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.