ddeunadv (External Interfaces/API Reference)

Release an advisory link between MATLAB and DDE server application

Syntax

rc = ddeunadv(channel, item, format, timeout)

Arguments
rc
The return code: 0 indicates the function call failed, 1 indicates it succeeded.

channel

The channel assigned to the conversation, returned by ddeinit.

item

A string that specifies the DDE item name associated with the advisory link.

format

(optional) A two-element array that specifies the format of the data for the advisory link. If you specified a format argument on the ddeadv function call that defined the advisory link, you must specify the same value on the ddeunadv function call. See ddeadv for a description of the format array.

timeout

(optional) A scalar that specifies the time-out limit for this operation. timeout is specified in milliseconds (1000 milliseconds = 1 second). The default value of timeout is three seconds.

Description

ddeunadv releases the advisory link between MATLAB and the server application, established by an earlier ddeadv call. The channel, item, and format must be the same as those specified in the call to ddeadv that initiated the link. If you include the timeout argument but accept the default format, you must specify format as an empty matrix.

Example

% Release the hot link established in the ddeadv example.
rc = ddeunadv(channel, 'r1c1:r5c5');

% Release a hot link with default format and a timeout value.
rc = ddeunadv(chan, 'r1c1:r5c5', [], 6000);

ddeterm C Engine Routines