Generic Function

Summary

Returns a list of the available general topics on a given server.

Package

win32

Signature

dde-server-topics server => topic-list

Arguments

server

A server object.

Values

topic-list

A list of strings.

Description

The generic function dde-server-topics returns a list of the available general topics on a given server. A suitable method specializing on the server class should be defined. Dispatching topics (see define-dde-dispatch-topic) should not be returned, as they are handled automatically by LispWorks. If you do not provide a dde-server-topics method, the default method returns :unknown , which prevents the DDE server from responding to the topics request.

Generally only one canonical name should be returned for each topic, even though the server may recognize several alternative forms of name for a topic. For example, if an application implements a topic for each open file, the topics foo , foo.doc and c:\foo.doc may all be acceptable strings for referring to the same topic; however dde-server-topics should return each topic once only.

The application must also provide a method on the dde-server-topic generic function.

See also

dde-server-topic
dde-topic-items