3.3.1 Calling Automation methods using a type library

There are three kinds of Automation method, each of which is called using macros designed for the purpose.

• Ordinary method are called using the macros call-dispatch-method and with-dispatch-interface.
• Property getter methods are called using the macro

call-dispatch-get-property.

• Property setter methods are called using the macros

call-dispatch-put-property

or the setf form of call-dispatch-get-property.

To use these macros, you need to specify the interface name, the method name, a COM interface pointer for the i-dispatch interface and suitable arguments. The interface and method names are given as symbols named as in The mapping from COM names to Lisp symbols and the COM interface pointer is a foreign pointer of type com-interface. In all the macros, the arg s and value s are as specified in the Data conversion when calling Automation methods.

The with-dispatch-interface macro is useful when several methods are being called with the same COM interface pointer, because it establishes a local macro that takes just the method name and arguments.