LDicomDS::RemovePresStateImageRefBySOPInstance

#include "Ltdic.h"

L_UINT16 LDicomDS::RemovePresStateImageRefBySOPInstance( pszSOPInstanceUID)

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
pszSOPInstanceUID	SOP Instance UID of the image to be removed from the IOD. Returns

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:	LDicomDS::SetPresStateInfo, LDicomDS::GetPresStateInfo, LDicomDS::RemoveAllPresStateImageRefs, LDicomDS::GetPresStateImageRefSOPInstance, LDicomDS::GetPresStateImageRefCount, LDicomDS::FindFirstPresStateRefSeriesItem, LDicomDS::FindNextPresStateRefSeriesItem, LDicomDS::GetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations

Example

L_VOID RemoveReferencedImage(LDicomDS& PresStateDS, L_CHAR*  pszSOPInstanceUID)
{
   L_UINT16 nRet = PresStateDS.RemovePresStateImageRefBySOPInstance (pszSOPInstanceUID);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL,
                  "Image has been successfully removed!",
                  "Success",
                  MB_OK);
   }
}