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 server names a client service registered with define-dde-client, the registered service name is used as the DDE service name. If server is any other symbol, the print name of the symbol is used as the DDE service name. If server is a string, that string is used as the DDE service name.

The topic argument 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.

The class argument 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 server 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.

See also

dde-disconnect