L_DicomGetPresStateImageRefBySOPInstance

#include "l_bitmap.h"

pDICOMELEMENT EXT_FUNCTION L_DicomGetPresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

HDICOMDS hDS;	/* a DICOM handle */
L_CHAR * 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_VOID GetImageBySOPInstance(HDICOMDS hPresStateDS, L_CHAR*  pszSOPInstanceUID)
{
   L_CHAR*  pszClassUID = NULL;
   L_CHAR   szText[256] = "\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, "Image Referenced SOP class UID is: %s ", pszClassUID);
          MessageBox( NULL,
                        szText,
                        "Note",
                        MB_OK);
        }
      }
   }
}