NWSMTSReturnToParent

Stops the current scan and continues the scan on the next qualified parent.

Syntax

  #include <smstsapi.h> 
   
  CCODE NWSMTSReturnToParent (
     UINT32   connection, 
     UINT32  *sequence);

connection: (IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServicEx.
sequence: (IN) Points to the sequence number returned by NWSMTSScanDataSetBegin or NWSMTSScanNextDataSet.

The following table lists the return values associated with the function.

0x00000000	Successful
0xFFFDFFB9	NWSMTS_UNSUPPORTED_FUNCTION
0xFFFDFFD8	NWSMTS_INVALID_SEQUENCE_NUMBER
0xFFFDFFE7	NWSMTS_INVALID_CONNECTION_HANDL
0xFFFDFFF3	NWSMTS_DATA_SET_IS_OPEN
0xFFFEFFFF	NWSMDR_INVALID_CONNECTION
0xFFFEFFFE	NWSMDR_INVALID_PARAMETER

Before NWSMTSReturnToParent is called, NWSMTSScanDataSetBegin must be called to initiate a scan.

When NWSMTSScanNextDataSet is called, the next parent is scanned.