L_DicomGetNextUnusedPrivateTag

Summary

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

Syntax

L_LTDIC_API L_UINT16 EXT_FUNCTION L_DicomGetNextUnusedPrivateTag(hDS, pPrivateCreatorDataElement, puTag)

Parameters

HDICOMDS hDS

A DICOM handle.

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.

Returns

Comments

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

• L_DicomCreatePrivateCreatorDataElement
• L_DicomFindFirstPrivateCreatorDataElement
• L_DicomFindNextPrivateCreatorDataElement

To create private elements in a DICOM data set. For more information on private elements, see L_DicomCreatePrivateCreatorDataElement function.

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:

After a successful call to the L_DicomGetNextUnusedPrivateTag function, *puTag will contains the value 0x00171202, which can be used with the L_DicomInsertElement function to add a new private element.

Required DLLs and Libraries

• LTDIC
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

See Also

Functions

• L_DicomCreatePrivateCreatorDataElement
• L_DicomFindFirstPrivateCreatorDataElement
• L_DicomFindNextPrivateCreatorDataElement
• L_DicomFindFirstPrivateElement
• L_DicomFindNextPrivateElement

Topics

• Working with Data Sets
• Data Sets: Inserting and Deleting Data Set Members

Example

For an example, refer to L_DicomCreatePrivateCreatorDataElement.