National Instruments 320682C Musical Toy Instrument User Manual


 
Chapter 6 DDE Library
© National Instruments Corporation 6-13 LabWindows/CVI Standard Libraries
See Also
ConnectToDDEServer, ClientDDERead
ConnectToDDEServer
int status = ConnectToDDEServer (unsigned int *conversationHandle,
char serverName[], char topicName[],
ddeFuncPtr clientCallbackFunction,
void *callbackData);
Purpose
Establishes a connection (conversation) between your program and a named server on a given
topic name.
Parameters
Input
serverName
string Name of the server application.
topicName
string Specifies the type of
conversation with the server.
clientCallbackFunction
DDE function
pointer
Pointer to the user callback
function.
callbackData
void pointer User-defined data.
Output
conversationHandle
unsigned integer Uniquely identifies the
conversation.
Return Value
status
integer Refer to error codes in
Table 6-3.
Parameter Discussion
The conversationHandle returns an integer value that uniquely represents a conversation
between a server and a client.
serverName and topicName must be strings of length from 1 to 255. They are used without
regard to case.
Each server application defines its own set of valid topic names. Refer to the command function
reference manual for the server application. A client and a server can have multiple connections
as long as they are under different topic names.