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.

Example:

(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