L_DicomFindNextPrivateCreatorDataElement

#include "Ltdic.h"

L_LTDIC_API pDICOMELEMENT EXT_FUNCTION L_DicomFindNextPrivateCreatorDataElement(hDS, pElement, bTree, pszIdCode, uElementGroup)

Returns the next Private Creator Data Element that matches the search constraints. This feature is available in version 16 or higher.

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set. The search for Private Creator Data Elements will be at the same level as pElement.

L_BOOL bTree

Flag that indicates how the Data Set will be evaluated. Possible values are:

Value Meaning
TRUE Evaluate the Data Set as a tree.
FALSE Evaluate the Data Set as a list

L_TCHAR * pszIdCode

Pointer to a string that uniquely identifies the Private Creator Data Element. Possible values are:

Value Meaning
NULL Search includes Private Creator Data Elements with any string value.
!NULL Search includes only those Private Creator Data Elements that have a string value that is the same as pszIdCode.

L_UINT16 uElementGroup

Group to search within. Possible values are:

Value Meaning
0 Search includes Private Creator Data Elements with any group.
0x0010 to 0x00FF Search includes only those Private Creator Data Elements in uElementGroup.

Returns

Value Meaning
!NULL A pointer to a DICOMELEMENT structure that contains the first Private Creator Data Element that matches the search constraints.
NULL An item with the specified search constraints does not exist.

Comments

Use this function after calling the L_DicomFindFirstPrivateCreatorDataElement function to find any or all the Private Creator Data Elements in a DICOM data set.

The search for private creator data elements is on the same level as the element pointed to by argument pElement. For the argument pElement, pass the value returned by the L_DicomFindFirstPrivateCreatorDataElement function or the value returned by the L_DicomFindNextPrivateCreatorDataElement function.

If bTree is TRUE, the data set is searched as a tree. If bTree is FALSE, the data set is searched as a list. For more information on the use of this parameter, see the L_DicomFindFirstElement function.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

Help Version 20.0.2019.9.20
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help