In This Topic ▼

L_DicomFindNextPrivateElement

#include " Ltdic.h "

L_LTDIC_API pDICOMELEMENT EXT_FUNCTION L_DicomFindNextPrivateElement(hDS, pElement, pPrivateCreatorDataElement)

Returns the next existing private element that is reserved by pPrivateCreatorDataElement. This feature is available in version 16 or higher.

Parameters

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the data set.

pDICOMELEMENT pPrivateCreatorDataElement

Pointer to a DICOMELEMENT structure, within the data set that is a Private Creator Data Element.

Returns

Value	Meaning
!NULL	A pointer to a DICOMELEMENT structure that contains the first Private Element reserved by pPrivateCreatorDataElement.
NULL	A Private Element was not found.

Comments

Use this function after calling the L_DicomFindFirstPrivateElement function to find any or all the private elements reserved by pPrivateCreatorDataElement. For more information on how Private Creator Data Elements are used to reserve private elements, see the documentation for the L_DicomCreatePrivateCreatorDataElement function.

The search for private elements is on the same level as the element pointed to by argument pPrivateCreatorDataElement. For the argument pElement, pass the value returned by the L_DicomFindFirstPrivateElement function or the value returned by the L_DicomFindNextPrivateElement function.

Required DLLs and Libraries