Q31524: MASM 5.10 EXT.DOC: FileNameToHandle - Returns Handle

Article: Q31524
Product(s): See article
Version(s): 5.10   | 5.10
Operating System(s): MS-DOS | OS/2
Keyword(s): ENDUSER | | mspl13_masm
Last Modified: 12-JAN-1989

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.

/*  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;

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1986-2002.