ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / TWAIN Component API Reference / TWAIN Component Functions Reference / Source Functions / IG_TWAIN_source_get_next
In This Topic
    IG_TWAIN_source_get_next
    In This Topic

    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.