DM DISCARDOBJECT

This message is sent to a source that supports the "DRM_DISCARD" rendering method.

Syntax

param1
PDRAGINFO pDragInfo;   /* Pointer to the DRAGINFO structure representing the items to be discarded. */

mpparam2
MPARAM ulReserved;    /* Reserved value, should be NULL. */

Parameters

pDragInfo (PDRAGINFO) - Input

Pointer to the DRAGINFO structure representing the items to be discarded.

ulReserved (MPARAM) - Input

Reserved value, should be NULL.

Returns

ulAction (ULONG) - returns

Flag.

DRR_SOURCE: The source window procedure accepts responsibility for the operation.

DRR_TARGET: The target window procedure is to accept responsibility for the operation. The OS/2 shell supports the discarding of dragitems that can be rendered by the DRM_OS2FILE method.

DRR_ABORT: Abort the entire DM_DROP action.

Remarks

This message is sent to the source window for the drag action. The source should make a copy of the parameters and return. The source should also create a separate thread to execute the discard action if it responds with DRR_SOURCE.

Default Processing

The WinDefWindowProc function does not expect to receive this message and takes no action on it, other than to set ulAction to the default value of NULL.