MLM EXPORT

This message exports text to a buffer.

Syntax

param1
PIPT * pBegin;    /* Starting point. */

param2
PULONG pCopy;     /* Number of bytes being exported. */

Parameters

pBegin (PIPT) - input/output

Starting point. Updated to follow the last character exported.

pCopy (PULONG) - input/output

Number of bytes being exported. Decremented by the number of bytes actually exported.

Returns

ulSuccess (ULONG) - return

Number of bytes successfully exported.

Remarks=

This message takes an insertion point and length as parameters, and copies text, starting from that insertion point, into the buffer set by MLM_SETIMPORTEXPORT. Text is in the format set by MLM_FORMAT. If the insertion point is -1, the selection is used for both pBegin and pCopy.

On return, pBegin is updated to follow the last byte exported, and the number of bytes to be exported is decremented by the number actually exported. This is done to prepare those parameter values for the next export. The return value indicates the number of bytes actually put into the buffer. This number is less than, or equal to, the buffer size (see MLM_SETIMPORTEXPORT).

Note

All exports are done in full characters. Therefore, if either

the length of the buffer or the number of bytes to be exported result in the last byte transferred being only half of a DBCS character, the MLE will not transfer that byte.

It returns the number of bytes placed in the export buffer.

Default Processing

The default window procedure takes no action on this message, other than to set ulSuccess to 0.