WM_DDE_UNADVISE

A DDE client application posts a WM_DDE_UNADVISE message to inform a DDE 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 data link for the specified item.

To post this message, call the PostMessage function with the following parameters.

PostMessage( 
  (HWND) hWnd,             // handle to destination window 
  WM_DDE_UNADVISE,         // message to send
  (WPARAM) wParam,         // handle to client window (HWND)
  (LPARAM) lParam          // format and item atom
);

Parameters

wParam

Handle to the client window sending the message.

lParam

The low-order word specifies the clipboard format of the item for which the update request is being retracted. If this is NULL, all active WM_DDE_ADVISE conversations for the item are to be terminated.

The high-order word contains a global atom that identifies the item for which the update request is being retracted. If this is NULL, all active WM_DDE_ADVISE links associated with the conversation are to be terminated.

Remarks

The client application allocates the high-order word of lParam by calling the GlobalAddAtom function.

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

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Dde.h; include Windows.h.

See Also

Dynamic Data Exchange Overview, Dynamic Data Exchange Messages, GlobalAddAtom, PackDDElParam, PostMessage, ReuseDDElParam, SendMessage, UnpackDDElParam, WM_DDE_ACK, WM_DDE_ADVISE