ImageGear for C and C++ on Windows v19.0
MED_ElemList_curr_data_get_string
| API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Element List Functions > MED_ElemList_curr_data_get_string |
This function gets the data from the Current Data Element, and always returns it to you as a NULL-terminated character string.
|
Copy Code
|
|
|---|---|
BOOL ACCUAPI MED_ElemList_curr_data_get_string (
HIGMEDELEMLIST hIGMedElemList,
LPCHAR lpString,
DWORD size_of_lpstring
);
|
|
| 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. |
Returns the number of ImageGear errors that occurred during the function call.
This function does not process image pixels.
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().