L_DicomRemovePresStateImageRefBySOPInstance

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomRemovePresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

HDICOMDS hDS;	/* a DICOM handle */
L_CHAR* pszSOPInstanceUID;	/* SOP Instance UID of the image to be removed */

Removes an item from the "Referenced Image Sequence" under the "Presentation State Module".

Parameter	Description
hDS	A DICOM handle.
pszSOPInstanceUID	SOP Instance UID of the image to be removed from the IOD.

Returns

0	SUCCESS
>0	An error occurred. Refer to Return Codes.

Comments

This function removes the reference to an image (SOP instance), by removing the item, which represents that instance under the "Referenced Image Sequence" in 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_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations
	Dicom Annotations: Presentation State Module

Example

L_VOID RemoveReferencedImage(HDICOMDS hPresStateDS, L_CHAR*  pszSOPInstanceUID)
{
   L_UINT16 nRet = L_DicomRemovePresStateImageRefBySOPInstance(hPresStateDS, pszSOPInstanceUID);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL, "Image has been successfully removed!", "Success", MB_OK);
   }
}