Syntax

   #include <nwbindry.h)
   
   NWCCODE  NWGetObjectNamesNextA (
      nuint32    luHandle,
      pnuint32   pluLenBuffer,
      pstr8      strBuffer);
   

Pascal Syntax

   uses calwin32 
   
   Function NWGetObjectNamesNextA( 
      luHandle : nuint32; 
      Var pluLenBuffer : nuint32;
      strBuffer : pnstr8
   ) : NWCCODE; stdcall;
   

Parameters

luHandle

(IN) Specifies the handle returned from NWGetObjectNamesBeginA.

pluLenBuffer

(IN/OUT) Points to the size of the buffer strBuffer passed to the function call. If the function returns NWE_BUFFER_OVERFLOW then this parameter holds the minimum buffer size for this call to be successful.

strBuffer

(OUT) Returns the name of a tree or server.

Return Values

Returns zero on success. The most common return values on failure include the following:

Remarks

NWGetObjectNamesNextA iteratively returns alphabetically ordered names in ASCII format, one name at a time, until NO_MORE_ENTRIES is returned.

NWGetObjectNamesBeginA must be called before you call NWGetObjectNamesNextA the first time.

The luObjectType parameter of NWGetObjectNamesBeginA determines whether NWGetObjectNamesNextA returns tree names or server names.

See Also

NWGetObjectNamesBeginA, NWGetObjectNamesEndA