DM RENDERPREPARE

This message tells a source to prepare for the rendering of an object.

Syntax

param1
PDRAGTRANSFER pDxfer; /* Pointer to a DRAGTRANSFER structure. */

param2
ULONG ulReserved;    /* Reserved value, should be 0. */

Parameters

pDxfer (PDRAGTRANSFER) - Input

Pointer to a DRAGTRANSFER structure.

ulReserved (ULONG) - Input

Reserved value, should be 0.

Returns

rc (BOOL) - returns

Success indicator:

TRUE: The message was processed by the recipient and it is ready to perform the rendering operation. The target of the drop sends a DM_RENDER message to request the rendering with a specific rendering mechanism and format.

FALSE: The message either was not processed by the recipient, or it is unprepared to perform the rendering. The hwndItem field in DRAGITEM may not be properly initialized, and therefore the target should not send a DM_ENDCONVERSATION message.

Remarks

This message must be sent when DC_PREPARE is on in the DRAGITEM structure.

This message is used to allow the source to create an invisible window to handle the conversation required for the data transfer.

Default Processing

The WinDefWindowProc function does not expect to receive this message and takes no action other than to return 0.