L_DicomGetParentKey
#include "ltdic.h"
pDICOMELEMENT EXT_FUNCTION L_DicomGetParentKey(hDS, pElement)
|
HDICOMDS hDS; |
/* a DICOM handle */ |
|
pDICOMELEMENT pElement; |
/* pointer to a DICOMELEMENT structure */ |
Returns a pointer to the item in the Dicom Dir Data Set that contains the parent of the specified item.
|
Parameter |
Description |
|
hDS |
A DICOM handle. |
|
pElement |
Pointer to a DICOMELEMENT structure that contains an item in the Data Set. |
Returns
|
!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 |
See Also
|
Functions: |
L_DicomGetFirstKey, L_DicomGetLastKey, L_DicomGetNextKey, L_DicomGetPrevKey, L_DicomGetRootKey, L_DicomGetChildKey |
|
Topics: |
Example
For an example, refer to L_DicomInsertKey.