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

 DrvDirHandleGet()
------------------------------------------------------------------------------
 Purpose:
 Get the directory handle for a drive.

 Syntax:
 iHandle = DrvDirHandleGet( lpszDrive )

 Parameters:
 lpszDrive The drive letter.

 Returns:
 A numeric value (signed short int).

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

 Description:
 DrvDirHandleGet() returns the NetWare directory handle of the drive
 specified by its letter lpszDrive. If a null string is passed,
 DrvDirHandleGet() assumes the current drive.

 NetWare keeps track of directories by their handles rather than their names
 and returns a unique handle whenever a drive is mapped.

 Returns NOVERRINT if an error occurs.

 Example:
 // To return the handle of the current directory.
 iCurrHandle = DrvDirHandleGet()
 if ( iCurrHandle != NOVERRINT )
    ? "The current drive directory handle is", iCurrHandle
 endif