NWDSItrAtFirst

Determines whether the specified iterator object is positioned at the beginning of the list.

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> 
   
  nbool8  NWDSItrAtFirst ( 
     nuint_ptr    Iterator);
  

Parameters

Iterator

(IN) Specifies the iterator object to determine whether it is positioned at the beginning of the list

Return Values

N_TRUE

Indicates that the iterator object is at the beginning of the list

N_FALSE

Indicates that the iterator object is not at the beginning of the list or that the list is empty.

Remarks

This function returns a boolean value.

This function works on all iterator objects, including those that are not positionable.

For sample code, see Section 4.5, Getting Iterator Information: Example.

NCP Calls

See Also

NWDSItrAtEOF, NWDSItrGetPosition