L_DicomRemovePresStateImageRefBySOPInstance

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomRemovePresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

HDICOMDS hDS;	/* a DICOM handle */
L_TCHAR* 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

DICOM_SUCCESS	The function was successful.
>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

Platforms

Win32, x64

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_INT DicomRemovePresStateImageRefBySOPInstanceExample(
   HDICOMDS hPresStateDS,
   L_TCHAR* pszSOPInstanceUID)
{
   L_UINT16 nRet = L_DicomRemovePresStateImageRefBySOPInstance(hPresStateDS, pszSOPInstanceUID);
   if (nRet == DICOM_SUCCESS)
      MessageBox( NULL, TEXT("Image has been successfully removed!"), TEXT("Success"), MB_OK);
   return nRet;
}