Home > Language Reference > Classes > StreamExg

NextObject Method

Begins sending a new object.

Syntax

Public Sub NextObject(ByRef sFilename As String)

Remarks

The NextObject method stops sending the current object, then starts to send a new object whose name is specified by the sFileName parameter. It is not necessary for the destination application to be the same as the destination application of the previous object. The file extension can therefore be different to that specified when the connection was opened with Connect.

From the point of view of the receiving device, the destination application receives a new ExgAskUser and ExgReceive event for each new object transmitted. This takes places as if the connection had been closed and then re-opened with a new file name.

This method is only available on Palm OS^® 4.0 and higher. Its use on an earlier version can cause unpredictable events.

The MiniLauncher sample shows an example using this method to send several databases consecutively within the same connection.

System requirements