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.