NWDSItrSetPositionFromIterator

Sets the iterator’s current position to the source iterator’s position.

Local Servers:blocking

Remote Servers:blocking

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98

Library:Cross-Platform NDS (NET*.*)

Service:NDS Iterator

Syntax

  #include <nwnet.h> 
  or 
  #include <nwitr.h> 
   
  NWDSCCODE  NWDSItrSetPositionFromIterator ( 
     nuint_ptr   Iterator, 
     nuint_ptr   srcIterator, 
     nuint32      timeout);

Parameters

Iterator: (IN) Specifies the iterator object that will have its position changed.
srcIterator: (IN) Specifies the source iterator.
timeout: (IN) Specifies the time (in milliseconds) allowed before returning an error.

Return Values

0x0000 0000	SUCCESSFUL
ERR_ITR_INVALID_HANDLE	Indicates the Iterator parameter was not a valid iterator object or that one iterator was from an NDS 8 server and the other one was not.
nonzero value	Nonzero values indicate errors. See NDS Return Values (-001 to -799).

Remarks

For NDS 8, the two iterators do not need to be identical. The system tries to find the closest match in the srcIterator and positions the destination one accordingly.

For NDS server not running NDS 8, the Iterator must be a clone of the srcIterator.

Both iterators must either be from NDS 8 servers or from servers not running NDS 8. If one references an NDS 8 server and the other a server that is not running NDS 8, an error (ERR_ITR_INVALID_HANDLE) is returned.

NCP Calls

0x2222 104 02 Send eDirectory Fragmented Request/Reply