Address of the handle associated with this DosFindFirst
request.
The values that can be specified for the handle are shown in the following
list:
HDIR_CREATE (0xFFFFFFFF)
The system allocates and
returns a handle. Upon return to the caller, phdir contains the handle
allocated by the system for use by the process. Allocating a handle for
each search allows recursive searches to be done and provides better performance
on lengthy searches. This is the recommended option to use.
HDIR_SYSTEM
(0x00000001)
The system assigns the handle for
standard output, which is always available to a process. This handle should
never be closed and used only for short, non-recursive searches in a single
threaded program.
The DosFindFirst handle is used
with subsequent DosFindNext requests.
Reuse of this handle in another DosFindFirst request closes the association
with the previous DosFindFirst request, and opens a new association with
the current DosFindFirst request.