Function References > L_DicomGetParentKey
In This Topic ▼
L_DicomGetParentKey
Summary
Returns a pointer to the item in the Dicom Dir Data Set that contains the parent of the specified item.
Syntax
#include "ltdic.h"
L_LTDIC_API pDICOMELEMENT L_DicomGetParentKey(hDS, pElement)
Parameters
HDICOMDS hDS
A DICOM handle.
pDICOMELEMENT pElement
Pointer to a DICOMELEMENT structure that contains an item in the Data Set.
Returns
| Value | Meaning |
|---|---|
| !NULL | A pointer to a DICOMELEMENT structure that contains the item in the Data Set that is the parent of the item specified in pElement. |
| NULL | pElement has no parent. (pElement is a Level 0 item.) |
Comments
The parent is the ancestor one level higher than the specified item. If the specified item is a Level 0 item, this function will return NULL. Please note that the numbering of the items in this illustration is arbitrary and does not imply order.
| If the passed pointer points to | The function returns a pointer to |
|---|---|
| Item 1 | NULL |
| Item 2 | Item 3 |
| Item 4 | Item3 |
| Item 5 | Item 6 |
The following functions will also help you navigate the Data Set:
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_DicomGetFirstKey
- L_DicomGetLastKey
- L_DicomGetNextKey
- L_DicomGetPrevKey
- L_DicomGetRootKey
- L_DicomGetChildKey
Topics
Example
For an example, refer to L_DicomInsertKey.
Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices © 1991-2024 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help
