In This Topic ▼

L_DicomGetPresStateInfo

Summary

Retrieves the attributes of the "Presentation State Module".

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomGetPresStateInfo(hDS, pPresState, uStructSize)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMPRESSTATEINFO pPresState

Pointer to a structure which will be filled with the "Presentation State Module" attributes.

L_UINT uStructSize

Size of the DICOMPRESSTATEINFO structure. Pass sizeof(DICOMPRESSTATEINFO).

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

This function will retrieve the attributes of the "Presentation State Module" and store their values in the structure pointed to by pPresState.

pPresState->uStructSize will be set to the value of the parameter uStructSize.

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.

Example

L_INT DicomGetPresStateInfoExample(HDICOMDS hPresStateDS) 
{ 
   DICOMPRESSTATEINFO   PresState = {0}; 
   L_UINT16             nRet; 
 
   nRet = L_DicomGetPresStateInfo(hPresStateDS, &PresState, sizeof(DICOMPRESSTATEINFO)); 
   if (nRet == DICOM_SUCCESS) 
   { 
      L_TCHAR szText[256] = TEXT("\0"); 
      if(PresState.pszPresDescription) 
      { 
         wsprintf(szText,  
                  TEXT("Presentation State description is: %s "),  
                  PresState.pszPresDescription); 
      } 
      else 
         wsprintf(szText, TEXT("Presentation State description is missing")); 
 
      MessageBox(NULL, szText, TEXT("Note"), MB_OK); 
   } 
   return nRet; 
}