Terminates the read session started by NWSMTSReadDataSets when all the data sets have not been completed read.
#include <smstsapi.h>
CCODE NWSMTSEndReadDataSets (
UINT32 connection,
UINT32 *readHandle);
(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServiceEx.
(IN/OUT) Points to the handle freed when NWSMTSEndReadDataSets returns.
See Section 9.3, Target Service Return Values for more information.
The following table lists the return values associated with the function.
Before NWSMTSEndReadDataSets is called, NWSMTSScanDataSetBegin must be called to initiate the scan and NWSMTSReadDataSets must be called to initiate the read.
NWSMTSEndReadDataSets frees all the memory allocated within readHandle. The readHandle parameter internally maintains the sequence structure, the set handle, and the read state.
If NWSMTSReadDataSets is called until all data sets have been read, all memory allocated within readHandle will be freed the last time NWSMTSReadDataSets is called so calling NWSMTSEndReadDataSets is not required.
IMPORTANT:This API is not supported in NetWare 6.5.