Name
hw_BeginDirScan -- start iteration over all directory entries (V5.0)
Synopsis
int error = hw_BeginDirScan(APTR handle, APTR *dirhandle);
Function
This function initiates a directory scanning operation on the handle specified in parameter 1. This handle must have been obtained by hw_Lock(). You have to pass a pointer to an APTR to this function in parameter 2. This pointer will receive a special directory handle that you have to pass to hw_EndDirScan() once you are finished with the directory scanning. See hw_EndDirScan for details.

To iterate over the single directory entries, call hw_NextDirEntry(). See hw_NextDirEntry for details.

Designer compatibility
Supported since Designer 4.0

Inputs
handle
handle returned by hw_Lock()
dirhandle
pointer to an APTR to receive the scan handle
Results
error
error code or 0 on success
Show TOC