Opens the data set referenced by the sequence value that returned the scanning functions.
#include <smstsapi.h>
CCODE NWSMTSOpenDataSetForBackup (
UINT32 connection,
UINT32 sequence,
UINT32 mode,
UINT32 *dataSetHandle);
(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServiceEx.
(IN) Specifies the sequence number returned by NWSMTSScanDataSetBegin or NWSMTSScanNextDataSet.
(IN) Specifies the generic and TSA-specific open mode to apply to the data set (see Open Modes for possible values).
(OUT) Points to a handle used to subsequently call NWSMTSReadDataSet or NWSMTSCloseDataSet.
See Section 9.3, Target Service Return Values for more information.
The following table lists the return values associated with the function.
Before NWSMTSOpenDataSetForBackup is called, NWSMTSScanDataSetBegin must be called to initiate the scan.
The TSA must ensure that no attributes are altered on the Target Service during the backup session.
NWSMTSOpenDataSetForBackup prepares the Target Service data set to be backed up. To close the data set, call NWSMTSCloseDataSet.
To determine the existing TSA-specific open modes for a given TSA, call NWSMTSGetOpenModeOptionString.