L_DicomRemoveAllPresStateImageRefs

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomRemoveAllPresStateImageRefs(hDS)

HDICOMDS hDS;

/* a DICOM handle */

Removes all "Referenced Image Sequence(s)", which belong to the "Referenced Series

Sequence" under the "Presentation State Module".

Parameter

Description

hDS

A DICOM handle.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function will remove all "Referenced Image Sequence(s)" (0008,1140), which belong to the "Referenced Series Sequence" (0008,1115) under the "Presentation State Module".

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_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Presentation State Module

Example

L_VOID RemoveAllReferencedImages(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet = L_DicomRemoveAllPresStateImageRefs(hPresStateDS);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL, "Images have been successfully removed!", "Success", MB_OK);
   }
}