L_DicomGetChildKey
#include "ltdic.h"
pDICOMELEMENT EXT_FUNCTION L_DicomGetChildKey(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 first key element child 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 first key element child of the item specified in pElement. |
NULL |
pElement has no child items. |
Comments
The child is the offspring one level lower than the specified item. If the specified item has no child items, this function will return NULL. For example:
If the passed pointer points to : |
The function returns a pointer to : |
Item 1 |
NULL |
Item 2 |
Item 3 |
Item 4 |
Item 5 |
Item 6 |
NULL |
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_DicomGetParentKey |
Topics: |
Example
For an example, refer to L_DicomInsertKey.