Enumerate a DOS directory synchronously into List entries containing
copied FileInfoBlock records. Construction installs local construct,
destruct and display hooks, then applies Dirlist tags through its
setter. A non-NULL Directory tag can therefore perform filesystem I/O
before construction returns. Directory and pattern strings and
FilterHook are borrowed; list records and the generated Path string are
owned by the object.
The default display has six columns in this order: name, size or drawer
image, DOS date, time, protection flags and comment. The display hook
always writes six slots. A caller-supplied List_Format is accepted
without adapting the hook; retain a compatible six-column format. Its
temporary size/date/time/protection strings are instance buffers
overwritten by later display calls. DateToStr status is ignored.
Protection display shows script, pure, archive and owner
read/write/execute/delete flags, not an exhaustive protection-word
display.
The constructor replaces the List construction/destruction/display hooks
after superclass construction. Do not preload incompatible
List_SourceArray entries or replace these hooks while copied directory
records are present. Entries retrieved through List methods are borrowed
records with a FileInfoBlock as their first member; they become invalid
when removed, cleared or disposed.
A directory scan allocates one FileInfoBlock, takes a shared lock,
examines the target and iterates ExNext only for a positive directory
type. Entries with positive fib_DirEntryType are drawers; other types
follow the file path. There is no recursion, background worker, UI input
pumping, cancellation method or timeout. Filesystem operations and
filter callbacks can block the caller.