ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / TWAIN Component API Reference / TWAIN Component Functions Reference / Device File System Functions / IG_TWAIN_file_get_next
In This Topic
    IG_TWAIN_file_get_next
    In This Topic

    This function gets the next filename in a directory, and returns information about that file (the same information that can be retrieved with IG_TWAIN_file_info_get()).

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_TWAIN_file_get_next(
            LPAT_TWAIN_FILEINFO lpFileInfo
    );
    

    Arguments:

    Name Type Description
    lpFileInfo LPAT_TWAIN_FILEINFO Pointer to an AT_TWAIN_FILEINFO structure that receives information about the next file in a directory.

    Return Value:

    Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Remarks:

    The Data Source positions the file system context to point to the next filename. lpFileInfo->szName contains the absolute path and name of the file. If the Application calls IG_TWAIN_file_get_image(), the current image will be transferred. A call to IG_TWAIN_file_get_first() must be issued on a given directory before the first call to IG_TWAIN_file_get_next().