L_DicomGetPresStateImageRefBySOPInstance

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetPresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

HDICOMDS hDS;	/* a DICOM handle */
L_TCHAR * pszSOPInstanceUID;	/* SOP Instance UID of the image */

Returns a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module".

Parameter	Description
hDS	A DICOM handle.
pszSOPInstanceUID	SOP Instance UID of the image whose item element will be retrieved.

Returns

!NULL	SUCCESS
NULL	An error occurred.

Comments

This function will return a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module". A NULL pointer will be returned if the item could not be found.

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_DicomSetPresStateInfo, L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem
Topics:	Working with DICOM Annotations
	Dicom Annotations: Presentation State Module

Example

L_INT DicomGetPresStateImageRefBySOPInstanceExample(
   HDICOMDS hPresStateDS,
   L_TCHAR*  pszSOPInstanceUID)
{
   L_TCHAR*  pszClassUID = NULL;
   L_TCHAR   szText[256] = TEXT("\0");
   pDICOMELEMENT pElement = L_DicomGetPresStateImageRefBySOPInstance (hPresStateDS,
                                                                     pszSOPInstanceUID);
   if (pElement)
   {
      pElement = L_DicomGetChildElement(hPresStateDS,pElement, TRUE);
      if (pElement)
      {
         pElement    = L_DicomFindFirstElement( hPresStateDS,pElement, 
                                                TAG_REFERENCED_SOP_CLASS_UID, 
                                                TRUE);
         pszClassUID = L_DicomGetStringValue(hPresStateDS,pElement, 0, 1);
         if (pszClassUID)
         {
            wsprintf(szText, TEXT("Image Referenced SOP class UID is: %s "), pszClassUID);
            MessageBox( NULL, 
                        szText, 
                        TEXT("Note"), 
                        MB_OK);      
         }
      }
      return DICOM_SUCCESS;
   }
   return DICOM_ERROR_NULL_PTR;
}