DM RENDERCOMPLETE

This message is posted by a source to a target window. It informs the target that the source has completed a requested rendering operation.

Syntax

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

param2
USHORT usFS;        /* Flag field. */

Parameters

pDxfer (PDRAGTRANSFER) - Input

Pointer to the DRAGTRANSFER structure. This must be the same pointer that was sent to the source in the DM_RENDER message.

usFS (USHORT) - Input

Flag field indicating successful completion:

DMFL_RENDERFAIL: The source is unable to perform the rendering operation. The target may be allowed to retry. If the target is allowed to retry and chooses not to, it must send a DM_ENDCONVERSATION message to the source.

DMFL_RENDEROK: The source has completed the rendering operation. When the target completes its part of the rendering operation, it must post a DM_RENDERCOMPLETE message to the source.

DMFL_RENDERRETRY: The source has completed the rendering operation and will allow the target to retry its part of the operation if it fails. This flag can be set in conjunction with either the DMFL_RENDERFAIL or DMFL_RENDEROK flags.

Returns

ulReserved (ULONG) - returns: Reserved value, should be 0.

Remarks

If the rendering operation failed for any reason, the source can allow the target to retry the operation. The source should return to the state it was in when the drop occurred for that object. The target resumes the rendering operation from the beginning.

If the rendering operation encounters a permanent failure, the source should fail the operation and proceed as if the rendering was completed.

If the rendering operation completes successfully, the source should return to the state it was in when the drop occurred for that object. This allows the target to retry the operation if its portion of the rendering failed. The target must post a DM_ENDCONVERSATION message when either of the following occurs:

It determines that the rendering operation successfully completed.
It chooses not to retry a rendering operation that failed.

Default Processing

The WinDefWindowProc function should send a DM_ENDCONVERSATION message to the window indicated in the hwndItem field of the DRAGITEM structure. The message should indicate that the target failed in its part of the rendering operation. Sending the DM_ENDCONVERSATION message allows the source to release the resources it dedicated to the rendering operation.