ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / MD Component API Reference / MD Component Functions Reference / Data Set Element List Functions / MED_ElemList_curr_data_get_string
In This Topic
    MED_ElemList_curr_data_get_string
    In This Topic

    This function gets the data from the Current Data Element, and always returns it to you as a NULL-terminated character string.

    Declaration:

     
    Copy Code
    BOOL ACCUAPI MED_ElemList_curr_data_get_string (
            HIGMEDELEMLIST hIGMedElemList, 
            LPCHAR lpString, 
            DWORD size_of_lpstring
    );
    

    Arguments:

    Name Type Description
    hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
    lpString LPCHAR A far pointer to a memory location which will be filled with the data from the Current Data Element as a NULL-terminated character string.
    size_of_lpString DWORD The variable which tells the function the length of lpString, in bytes, expressed as a DWORD. If you specify a string length that is not long enough to hold the data, the data will simply be truncated.

    Return Value:

    Returns the number of ImageGear errors that occurred during the function call.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Remarks:

    The marker to the Current Data Element can be moved using one of the MED_DCM_DS_move_...() functions.

    Data Elements can be of many different data types (int, word, bytes, float, double, string, etc.), but this function will always convert the data to a string. To return the data in its "natural form", use MED_DCM_DS_curr_data_get().