MED_ElemList_curr_data_get

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().