Click above to get retro games delivered to your door ever month!

 ObjDirList()
------------------------------------------------------------------------------
 Purpose:
 Get a list of the directories of which the object is a trustee.

 Syntax:
 lpszDirName=ObjDirList( iVolNum, dwObjID, bStartFlag )

 Parameters:
 iVolNum    The volume number.
 dwObjID    The bindery ID number of the object.
 bStartFlag Flag signifying start of list.

 Returns:
 A character string of length 255.

 The CA-Clipper name for this function is:
 ObjDirLst()

 Description:
 ObjDirList() is used to obtain a list of directories on the specified
 volume iVolNum to which the object specified by ID number dwObjID has
 access.

 ObjDirList() is called repeatedly. On the first call bStartFlag must be
 TRUE and is then set to FALSE on subsequent calls.

 Returns an empty string on the first call if an error occurs. Returns an
 empty string on subsequent calls when there are no more directories to
 return.

 NOTE: Under NetWare 386, ObjDirList() returns files to which the object has
 trustee rights as well as directories.

 Example:
 // To return a list of directories and their access rights for
 // user JANE on volume 0 (SYS):
 lpszCurrDir = ObjDirList( 0, UsrIDGet( "JANE" ), TRUE )
 do while !empty( lpszCurrDir )
    ? lpszCurrDir, "has access rights: "
    ?? NovRightsString( DirAccessRightsGet() )
    CurrDir = ObjDirList( 0, UsrIDGet( "JANE" ), FALSE )`
 enddo

 Notes:
 After an empty string is returned, check NWErrorGet().