ImageGear for C and C++ on Windows v19.1 - Updated
IG_TWAIN_source_get_next
API Reference Guide > TWAIN Component API Reference > TWAIN Component Functions Reference > Source Functions > IG_TWAIN_source_get_next

This function returns the name of the next Data Source detected.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_TWAIN_source_get_next(
        HWND hMainWnd,
        LPSTR lpszDSName
);

Arguments:

Name Type Description
hMainWnd HWND The handle of the main window in the application.
lpszDSName LPSTR Returns a string identifying the next Data Source detected. You must allocate the memory for this string. Please allow 34 characters per the TWAIN restriction.

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:

You should precede your first call to IG_TWAIN_source_get_next() with a call to IG_TWAIN_source_get_first().

Used in conjunction with IG_TWAIN_source_get_first(), you can implement your own version of TWAIN's "SelectSource" dialog box, adding customized enhancements or sophistication.