19.2.4 Request and poke transactions

LispWorks clients can issue request and poke transactions across a conversation using
dde-request
and
dde-poke
, which take a
conversation
(or a
service
designator/
topic
designator pair in the case of an automatically managed conversation), and an
item
as their main arguments. In the case of a poke transaction, data to be poked into
item
must also be provided.

In the case of a successful request transaction with
dde-request
or
dde-request*
, the data contained in
item
is returned to the LispWorks client by the server.

In the case of a successful poke transaction with
dde-poke
or
dde-poke*
, the data provided is poked into
item
by the server.

The accessor
dde-item
(or
dde-item*
for automatically managed conversations) can perform request and poke transactions. See the
LispWorks Reference Manual
for more details.

dde-item

Accessor

dde-item
conversation
item
&key
format
type
errorp

The accessor
dde-item
performs a request transaction when read. It performs a poke transaction when set.

dde-poke

Function

dde-poke
conversation
item
data
&key
format
type
errorp
=>
result

The function
dde-poke
issues a poke transaction on
conversation
to set the value of the item specified by
item
to the value specified by
data
. The argument
item
should be a string, or a symbol. If it is a symbol its print name is used.

dde-request

Function

dde-request
conversation
item
&key
format
type
errorp

The function
dde-request
issues a request transaction on
conversation
for the specified
item
. The argument
item
should be a string, or a symbol. If it is a symbol its print name is used.