Writes the data contained in the passed SFRecord or SFField into the filter's buffer beginning from the current buffer position. When using the binding methods in SFRecord this is done automatically. The method is for advanced applications only.

Syntax:

object.Put(objToWrite)

Parameters:

objToWrite - SFRecord or SFField object.

Remarks:

This function writes the data from the current position in the buffer (see buffPos). When SFRecord's BindTo method is used everything is done automatically - including rereading the buffer (if needed) and setting its position to 0. If your application needs low level control of the process it is able to write a record or a single field from the current position in the filter's buffer. For example this can be quite useful if you need to move some data from a normal record oriented stream to another destination (controlled directly through the filter).

Applies to: SFFilter object

Supported on:

Windows 95/NT and later
Windows CE 3.0 and later
Pocket PC/Windows Mobile 2003 and later
Windows CE.NET 4 and later