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

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

 Syntax:
 iHandle = DrvDirHanGet( lpszDrive )

 Parameters:
 lpszDrive The drive letter.

 Returns:
 A numeric value (signed short int).

 Description:
 DrvDirHanGet() returns the NetWare directory handle of the drive
 specified by its letter lpszDrive. If a null string is passed,
 DrvDirHanGet() 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 = DrvDirHanGet()
 if ( iCurrHandle != NOVERRINT )
    ? "The current drive directory handle is", iCurrHandle
 endif