#include "Ltdic.h"
L_LTDIC_API L_UINT16 EXT_FUNCTION L_DicomGetNextUnusedPrivateTag(hDS, pPrivateCreatorDataElement, puTag)
Returns the next available unused tag reserved by the Private Creator Data Element. This feature is available in version 16 or higher.
A DICOM handle.
Pointer to the Private Creator Data Element.
Pointer to a variable that is updated with the next unused private tag.
Value | Meaning |
---|---|
DICOM_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 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:
Tag | Description |
---|---|
(0017, 0012) | private creator data element |
(0017, 1200) | private element |
(0017, 1201) | private element |
(0017, 1205) | private element |
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
Win32, x64, Linux.
For an example, refer to L_DicomCreatePrivateCreatorDataElement.
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document