Collapse All Expand All

LDicomDS::GetParentKey

#include "ltdic.h"

pDICOMELEMENT LDicomDS::GetParentKey(pElement)

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
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:

LDicomDS::GetFirstKey

LDicomDS::GetLastKey

LDicomDS::GetNextKey

LDicomDS::GetRootKey

LDicomDS::GetChildKey

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

See Also

Functions:	LDicomDS::GetFirstKey, LDicomDS::GetLastKey, LDicomDS::GetNextKey, LDicomDS::GetPrevKey, LDicomDS::GetRootKey, LDicomDS::GetChildKey
Topics:	Working with Basic Directory Key Elements
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

For an example, refer to LDicomDS::InsertKey.