L_DicomGetPresStateImageRefBySOPInstance

Summary

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

Syntax

#include "ltdic.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetPresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

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

Platforms

Win32, x64, Linux.

See Also

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; 
} 
Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.