L_DicomSetPresStateInfo

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomSetPresStateInfo(hDS, pPresState)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMPRESSTATEINFO pPresState;	/* pointer to a structure */

Sets the attributes of the "Presentation State Module".

Parameter	Description
hDS	A DICOM handle.
pPresState	Pointer to a "Presentation State Module" attributes structure.

Returns

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

Comments

This function will set the attributes of the "Presentation State Module". Before calling this function, initialize pPresState->uStructSize to be sizeof(DICOMPRESSTATEINFO) and initialize all the members of the structure.

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

See Also

Functions:	L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations
	Dicom Annotations: Presentation State Module

Example

L_INT DicomSetPresStateInfoExample(HDICOMDS hPresStateDS)
{
   L_UINT16             nRet;
   VALUEDATE            Date;
   VALUETIME            Time;
   DICOMPRESSTATEINFO   PresState;
   SYSTEMTIME           SysTime;
   GetSystemTime(&SysTime);
   Date.nYear = SysTime.wYear; 
   Date.nMonth = SysTime.wMonth; 
   Date.nDay = SysTime.wDay;
   Time.nHours = SysTime.wHour;
   Time.nMinutes = SysTime.wMinute;
   Time.nSeconds = SysTime.wSecond;
   PresState.nInstanceNumber = 1;
   PresState.pszPresLabel = TEXT("Label");
   PresState.pszPresDescription = TEXT("Description");
   PresState.pszPresCreator = TEXT("Creator");
   PresState.pPresCreationDate = &Date;
   PresState.pPresCreationTime = &Time;
   PresState.uStructSize = sizeof(DICOMPRESSTATEINFO);
   nRet = L_DicomSetPresStateInfo(hPresStateDS,&PresState);
   if (nRet == DICOM_SUCCESS)
      MessageBox( NULL, TEXT("Presentation state has been successfully updated"), TEXT("Notice"), MB_OK);
   return nRet;
}