COPYDSCALLBACK Function

#include "ltdic.h"

L_BOOL pEXT_CALLBACK YourFunction(pElement, nFlags, pUserData)

pDICOMELEMENT pElement;	/* a DICOM handle */
L_UINT16 nFlags;	/* flag that indicates any errors */
L_VOID * pUserData;	/* pointer to additional data */

Called for each data element of the data set.

Parameter	Description
pElement	A DICOM handle.
nFlags	Reserved for future use. Pass 0 for this argument.
pUserData	Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the LDicomDS::CopyDS function.)
	Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

TRUE	Include the element pElement in the resulting copy.
FALSE	Do not include the element pElement in the resulting copy.

Comments

The LDicomDS::CopyDS function calls your callback function for each element of the data set. Return TRUE in the callback function if you want this element included in the resulting copy of the data set. Return FALSE if you do not want this element included.

Example

For an example, refer to LDicomDS::CopyDS.