Queries the interface pointer from a simple-i-dispatch object using the type information from another interface.
An interface pointer.
is used to obtain an interface pointer from a simple-i-dispatch interface. The simple-i-dispatch contains the interface name provided using its
initarg, but it doesn't have the details of this interface, so
must be able to find the details.
In the current implementation, the only way for the details to be found is by passing the related-dispatch argument. This should be an interface pointer from which type information about the interface name can be obtained.
function returns two values,
which is an interface pointer for the interface-name contained in
, which is the refguid of that interface-name.
A typical use of
is to implement a sink interface for events from some other component. The interface pointer for that component is passed as the
because that connects to the type library containing both interface definitions.
directly, consider the functions set-i-dispatch-event-handler and create-instance-with-events, which provide an succinct way to provide an event callback.