  |
GoFiler Legato Script Reference
Legato v 1.5d Application v 5.25a
|
| Table of Contents | < < Previous | Next >> |
Chapter Six — File Functions (continued)
Overview
The GetNextFile function retrieves the next item within a Folder Enumeration Object as created by the GetFirstFile function.
Syntax/Parameters
Syntax
int = GetNextFile ( handle hFolderEnum );
Parameters
hFolderEnum
A handle to a valid Folder Enumeration Object as created with the GetFirstFile function.
Return Value
Returns an int as ERROR_NONE or a formatted error code on failure. If all the entries are exhausted, the return value will be ERROR_EOD. Use the GetLastError function to retrieve error information.
Remarks
The properties of the item in the Folder Enumeration Object can be retrieved with functions such as the GetFilename and GetFileSize functions. The operation of the GetNextFile function cannot be unwound. To retrieve the information of previous entries, the GetFirstFile function must be called again to reset the items.
If the hFolderEnum parameter is invalid, the GetLastError function will return ERROR_INVALID_HANDLE.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
Legato IDE, Legato Basic
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.