MASM 5.10 EXT.DOC: FileNameToHandle - Returns Handle

ID Number: Q31524

5.10 | 5.10

MS-DOS | OS/2

Summary:

The following information is from the MASM Version 5.10 EXT.DOC

file.

Please note that numbering for both COL and LINE variables begins

with 0.

More Information:

/* FileNameToHandle - returns handle corresponding to the file name

*

* The FileNameToHandle function searches for the specified file

* and returns a handle to the file if found. If pName points to a

* zero-length string, then the function returns a handle to the

* current file. Otherwise, the function searches for the file named by

* pName which may include a complete path. If pName not found and

* pShortName is not a NULL pointer, then the function scans the information

* file for a file name that matches pShortName. If a match is found,

* then the function uses the complete path name in the information file.

*

* pName Pointer to name of file

* pShortName Pointer to short name of file (this parameter may be NULL)

*

* Returns Handle to specified file (if found) or NULL.

*/

PFILE pascal FileNameToHandle (pName, pShortName)

char far *pName, *pShortName;