WM_DDE_UNADVISE

2.x

#include <dde.h>

WM_DDE_UNADVISE
wParam = (WPARAM) hwnd;                 /* handle of posting window   */
lParam = MAKELPARAM(cfFormat, aItem);   /* clipboard format and item  */

A dynamic data exchange (DDE) client application posts a WM_DDE_UNADVISE message to inform a server application that
the specified item or a particular clipboard format for the item should no
longer be updated. This terminates the warm or hot link for the specified item.

Parameters

hwnd

Value of wParam. Identifies the sending window.

cfFormat

Value of the low-order word of lParam. Specifies the clipboard format of the item for which the update request is being retracted. When the cfFormat parameter is NULL, all active WM_DDE_ADVISE conversations for the item are to be terminated.

aItem

Value of the high-order word of lParam. Specifies the item for which the update request is being retracted. When aItem is NULL, all active WM_DDE_ADVISE conversations associated with the client are to be terminated.

Return Value

This message does not return a value.

Comments

Posting

The application posts the WM_DDE_UNADVISE message by calling the PostMessage function, not the SendMessage function.

The application allocates aItem by calling the GlobalAddAtom function.

Receiving

The application posts the WM_DDE_ACK message to respond positively or negatively. When posting WM_DDE_ACK, the application can reuse the aItem atom or delete it and create a new one.

See Also

GlobalAddAtom, PostMessage, WM_DDE_ACK