LDicomDS::FindFirstPrivateElement

#include " Ltdic.h "

pDICOMELEMENT LDicomDS::FindFirstPrivateElement(pPrivateCreatorDataElement)

pDICOMELEMENT pPrivateCreatorDataElement;

/* pointer to a DICOMELEMENT structure */

Returns the first existing private element that is reserved by pPrivateCreatorDataElement. This feature is available in version 16 or higher.

Parameter

Description

pPrivateCreatorDataElement

Pointer to a DICOMELEMENT structure within the data set that is a Private Creator Data Element

Returns

!NULL

A pointer to a DICOMELEMENT structure that contains the first Private Element reserved by pPrivateCreatorDataElement.

NULL

A Private Element was not found.

Comments

Use this method along with LDicomDS::FindNextPrivateElement to find any or all the private elements reserved by pPrivateCreatorDataElement. For more information on how Private Creator Data Elements are used to reserve private elements, see the documentation for LDicomDS::CreatePrivateCreatorDataElement.

The search for private elements is on the same level as the element pointed to by argument pPrivateCreatorDataElement

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:

LDicomDS::CreatePrivateCreatorDataElement, LDicomDS::GetNextUnusedPrivateTag, LDicomDS::FindFirstPrivateCreatorDataElement, LDicomDS::FindNextPrivateCreatorDataElement, LDicomDS::FindNextPrivateElement, Class Members

Topics:

Working with Data Sets

 

Data Sets: Searching a Data Set

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

For an example, refer to LDicomDS::FindFirstPrivateCreatorDataElement.