| Programming Guide | |
Creates a hot DDE link to a server
#include <smmwuser.h>int sm_dde_client_connect_hot(char *server, char *topic, char *item, char *field);
server- The server application's name—for example,
WINWORDtopic- The server topic, typically the file name of the spreadsheet or document—for example,
SALES.DOCitem- The server item—for example,
DDE_LINK1field- The name of the widget to receive server data.
Windows
- 1 Success.
sm_dde_client_connect_hotcreates a hot DDE link between a widget and a server application. Given a hot link, the server automatically updates the widget whenever the linked data changes.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 hot 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.