create-instance-with-events Function

Summary

A convenience function which combines create-instance and set-i-dispatch-event-handler.

Package

com

Signature

create-instance-with-events clsid event-handler &rest args &key event-object => interface, sinks

Arguments

Values

Description

The function create-instance-with-events is a convenience function which starts an i-dispatch interface and sets an event handler.

It first calls create-instance with clsid and all the keyword arguments in args except :event-object. clsid defaults the create-instance argument riid to the value i-dispatch.

It then calls set-i-dispatch-event-handler on the resulting interface, passing event-handler, event-object and clsid (as the coclass).

interface is the interface started, and sinks is the result of set-i-dispatch-event-handler.

Examples

(example-edit-file "com/automation/events/ie-events")

See also

create-instance
set-i-dispatch-event-handler