ddeunadv (External Interfaces/API Reference)

Release advisory link

Syntax

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

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.

If successful, ddeunadv returns 1 in variable, rc. Otherwise it returns 0.

Arguments

channel
Conversation channel from ddeinit.

item
String specifying the DDE item name for the advisory link. Changing the data identified by item at the server triggers the advisory link.

format (optional)
Two-element array. This must be the same as the format argument for the corresponding ddeadv call.

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

`channel`	Conversation channel from `ddeinit`.
`item`	String specifying the DDE item name for the advisory link. Changing the data identified by `item` at the server triggers the advisory link.
`format (optional)`	Two-element array. This must be the same as the `format` argument for the corresponding `ddeadv` call.
`timeout (optional)`	Scalar specifying the time-out limit for this operation. `timeout` is specified in milliseconds. (1000 milliseconds = 1 second). The default value of `timeout` is three seconds.

Example

To release an advisory link established previously with ddeadv:

rc = ddeunadv(channel, 'r1c1:r5c5')
rc = 

    1.00

See Also

ddeadv, ddeexec, ddeinit, ddepoke, ddereq, ddeterm

ddeterm Serial Port I/O Functions