L_DicomGetRootKey
#include "ltdic.h"
pDICOMELEMENT EXT_FUNCTION L_DicomGetRootKey(hDS, pElement)
|
HDICOMDS hDS; |
/* a DICOM handle */ |
|
pDICOMELEMENT pElement; |
/* pointer to a DICOMELEMENT structure */ |
Returns a pointer to the root 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 root of the item specified in pElement. |
|
NULL |
The Data Set is empty or pElement is NULL. |
Comments
The root is the Level 0 ancestor of pElement. If pElement points to an item on Level 0, a pointer to that same item will be returned. 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 |
Item 2 |
|
Item 3 |
Item 2 |
|
Item 4 |
Item4 |
|
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_DicomGetParentKey, L_DicomGetChildKey |
|
Topics: |
Example
For an example, refer to L_DicomInsertKey.