dde-connect

dde-connect Function

Summary

Attempts to create a conversation with a specified DDE server.

Package

win32

Signature

dde-connect service topic &key class errorp => object

Arguments

`service`⇩	A symbol or string.
`topic`⇩	A symbol or string.
`class`⇩	The class of the conversation object to create.
`errorp`⇩	A boolean.

Values

object

A conversation object.

Description

The function dde-connect attempts to create a conversation with a DDE server. If service names a client service registered with define-dde-client, the registered service name is used as the DDE service name. If service is any other symbol, the print name of the symbol is used as the DDE service name. If service is a string, that string is used as the DDE service name.

topic specifies the DDE topic name to be used in the conversation. If it is a symbol, the symbol's print name is used. If it is a string, the string is used.

class specifies the class of the conversation object to create. It must be a subclass of dde-client-conversation, or nil. If it is nil (the default value), then a conversation of class dde-client-conversation is created, unless service names a client service registered with define-dde-client, in which case the registered class (if any) is used.

On executing successfully, this function returns a conversation object. If unsuccessful, the behavior depends on the value of errorp. If errorp is t (the default value), then an error is raised. If errorp is false, the function returns nil.

Note that conversation objects may only be used within the thread in which they were created.