In This Topic ▼

L_DicomGetPresStateImageRefBySOPInstance

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetPresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

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

Parameters

HDICOMDS hDS

A DICOM handle.

L_TCHAR * pszSOPInstanceUID

SOP Instance UID of the image whose item element will be retrieved.

Returns

Value	Meaning
!NULL	The function was successful.
NULL	An error occurred. Refer to the Return Code.

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

Platforms

Win32, x64, Linux.

Functions

Topics

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; 
}

Download our FREE evaluation

Help Version 21.0.2021.7.2

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Quick Reference

Function References

Appendix