Programming Guide


Creates a warm DDE link to a server

#include <smmwuser.h>
int sm_dde_client_connect_warm(char *server, char *topic, char *item, char *field);

The server application's name—for example, WINWORD

The server topic, typically the file name of the spreadsheet or document—for example, SALES.DOC

The server item—for example, DDE_LINK1

The name of the widget to receive server data.





sm_dde_client_connect_warm creates a warm DDE link between a widget and a server application. Given a warm link, the server notifies the client Panther application of changes to linked data. However, the application must explicitly request data updates by calling sm_dde_client_request.

When the server notifies Panther that linked data has changed, Panther checks whether a callback function is installed and uses it to notify the application; otherwise, it uses its own callback function. Use sm_dde_install_notify to install a callback function.

Before creating a link, Panther must be enabled as a client. Panther checks whether a connection to the server application already exists—for example, another open screen has a link to this server. If no connection exists, Panther attempts to establish one. After Panther verifies or establishes a connection, it creates a warm link between the widget and the specified topic and item.

This function can succeed only if the server application is already running; otherwise Panther posts an error message. If the link cannot be created, Panther posts an error message.

See Also

sm_dde_client_request, sm_dde_install_notify