DOSFindFirstFile

Searches for files in the DOS partition

Local Servers:blocking
Remote Servers:N/A
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:DOS Partition

Syntax

  #include <nwdos.h>  
   
  int DOSFindFirstFile  (  
     const char     *fileName,   
     WORD            searchAttributes,   
     struct find_t  *diskTransferAddress);

Parameters

fileName
(IN) Points to the name of the file to be found in the DOS partition (full paths, including a drive letter and wildcards, are allowed).
searchAttributes
(IN) Specifies the type of file for which to search.
diskTransferAddress
(OUT) Points to DOS information about the file.

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

DOSCode

UNSUCCESSFUL

Remarks

DOSFindFirstFile finds the first file that matches the fileName and searchAttributes parameters. If wildcards are used in the fileName parameter, call DOSFindNextFile to find other files that also match the fileName and searchAttributes parameters.

searchAttributes can have the following values (defined in the nwdos.h file):

See Also

DOSFindNextFile, DOSPresent