NWDSItrClone

Creates a copy of the iterator.

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  NWDSItrClone ( 
     nuint_ptr    Iterator, 
     pnuint_ptr    pNewIterator);

Parameters

Iterator: (IN) Specifies the iterator object to copy.
pNewIterator: (OUT) Points to the new iterator object.

Return Values

0x0000 0000	SUCCESSFUL
ERR_ITR_INVALID_HANDLE	Indicates the Iterator parameter was not a valid iterator object.
nonzero value	Nonzero values indicate errors. See NDS Return Values (-001 to -799).

Remarks

This function creates a second iterator with all the characteristics of the original iterator. When cleaning up, you must destroy both the original and the new iterator.

For sample code, see Section 4.1, Cloning an Iterator Object: Example.

NCP Calls