dde-advise-stop*

dde-advise-stop* Function

Summary

Removes a link from an automatically managed conversation specified by a given item and key.

Package

win32

Signature

dde-advise-stop* service topic item &key key format errorp disconnectp => result

Arguments

`service`⇩	A string or symbol.
`topic`⇩	A string or symbol.
`item`⇩	A string or symbol.
`key`⇩	An object.
`format`⇩	A clipboard format specifier.
`errorp`⇩	A boolean.
`disconnectp`⇩	A boolean.

Values

result

A boolean.

Description

The function dde-advise-stop* is similar to the function dde-advise-stop, and removes a particular link indicated by item, format and key from a conversation with the server specified by service on a topic given by topic. If key is the last key for the pair of item and format, then the advise loop for the pair is terminated.

See 22.2.3 Advise loops for information about DDE advise loops.

If disconnectp is t (the default value), and the last advise loop for the conversation is terminated, the conversation is disconnected.

If this function succeeds, it returns t. If it fails, the behavior depends on the value of errorp. If errorp is t (the default value), LispWorks signals an error. If errorp is nil, the function returns nil to indicate failure.