#include " Ltdic.h "

L_UINT16 LDicomDS::GetNextUnusedPrivateTag(pPrivateCreatorDataElement,puTag)

Returns the next available unused tag reserved by the Private Creator Data Element. This feature is available in version 16 or higher.


pDICOMELEMENT pPrivateCreatorDataElement

Pointer to the Private Creator Data Element.

L_UINT32 * puTag

Pointer to a variable that is updated with the next unused private tag.


Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.


This function is used together with any of the following functions:

to create private elements in a DICOM data set. For more information on private elements, see LDicomDS::CreatePrivateCreatorDataElement.

Use this function with an existing private creator data element to create private elements. If successful, argument *puTag will contain the next available unused tag that has been reserved by the private creator data element pointed to by argument pPrivateCreatorDataElement.

For example, suppose the following tags exist in a DICOM data set:

Tag Name
(0017, 0012) private creator data element
(0017, 1200) private element
(0017, 1201) private element
(0017, 1205) private element

After a successful call to LDicomDS::GetNextUnusedPrivateTag, *puTag will contains the value 0x00171202, which can be used with LDicomDS::InsertElement to add a new private element.

Required DLLs and Libraries


Win32, x64

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

LEADTOOLS DICOM C++ Class Library Help