National Instruments 320682C Musical Toy Instrument User Manual


 
DDE Library Chapter 6
LabWindows/CVI Standard Libraries 6-22 © National Instruments Corporation
Parameter Discussion
The itemName represents the information in the server application where the DDE link is
established. For example, the item name could represent an Excel range of cells by using the
range description R1C1:R10C10.
Note: To the client, LabWindows/CVI does not distinguish between a hot link and a warm
link. For both types of links, the clientCallbackFunction is called with a transaction
type of DDE_DATAREADY when the data item is changed at the server site, and the new
data is available in the dataPtr parameter of the callback function. LabWindows/CVI
has two different functions for setting up a warm link or hot link in case some
applications only accept one or the other kind of link.
See Also
RegisterDDEServer, SetUpDDEHotLink
TerminateDDELink
int status = TerminateDDELink (unsigned int conversationHandle,
char itemName[], unsigned int dataFormat,
unsigned int timeout);
Purpose
Lets your program, acting as a DDE client, terminate an advisory link, previously set up with the
server either through SetUpDDEWarmLink or SetUpDDEHotLink.
This function returns zero for success or a negative error code for failure.
Parameters
Input
conversationHandle
unsigned integer Uniquely identifies the conversation.
itemName
string Uniquely identifies the output item; for
example, system.
dataFormat
unsigned integer Valid data format; for example, CF_TEXT.
timeout
unsigned integer Timeout in ms.
Return Value
status
integer Refer to error codes in Table 6-3.