define-dde-dispatch-topic Macro

Summary

Defines a dispatch topic.

Package

win32

Signature

define-dde-dispatch-topic name &key server topic-name => name

Arguments

name⇩	A symbol.
server⇩	A server class.
topic-name⇩	A string.

Values

name

A symbol.

Description

The macro define-dde-dispatch-topic defines a dispatching topic. A dispatching topic is a topic which has a fixed name and always exists. Dispatching topics provide dispatching capabilities, whereby appropriate application-supplied code is executed for each supported transaction. Note that the server implementation also provides some dispatching capabilities.

The name of the dispatching topic object is specified by name.

The topic is identified by the string topic-name.

The class of the server to attach the topic to is given by server.

The macro define-dde-dispatch-topic returns the name of the dispatching topic, name.

Use define-dde-server-function with the :topic option to define items for a dispatch topic.

Examples

(define-dde-dispatch-topic topic1 :server demo-server)

(define-dde-server-function (item1 :topic topic1)
    :request
    ()
  ..handle topic1.item1 request..)

See also

dde-server-topic
dde-server-topics
define-dde-server-function