4.12 The OLE-AUTOMATION module

with-dispatch-interface

Statement macro

Summary

Runs a body of code while connected to an Automation server.

Macro call

with-dispatch-interface (variable = class-id, #rest keys) 
  body 
end => values

Arguments

variable: A Dylan variable-namebnf.
class-id: An instance of <string> or <REFGUID>.
keys: Instances of <object>.
body: A Dylan bodybnf.

Values

values: Instances of <object>.

Description

Provides a safe mechanism for working with an Automation server. The macro obtains a dispatch interface pointer to an Automation object, binds it to variable, evaluates a body of code within the context of this binding, and then releases the interface pointer. The interface pointer is created as if by passing the class-id and any keys to the function create-dispatch.

The values of the last expression in body are returned.