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_first
In This Topic
    IG_TWAIN_source_get_first
    In This Topic

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

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_TWAIN_source_get_first(
            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 which Data Source is the first one 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:

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