LDicomDS::RemovePresStateImageRefBySOPInstance

#include "Ltdic.h"

L_UINT16 LDicomDS::RemovePresStateImageRefBySOPInstance( pszSOPInstanceUID)

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

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

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

L_INT LDicomDS_RemovePresStateImageRefBySOPInstanceExample(LDicomDS& PresStateDS, L_TCHAR*  pszSOPInstanceUID) 
{
   L_INT nRet;
   nRet = PresStateDS.RemovePresStateImageRefBySOPInstance (pszSOPInstanceUID); 
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL, 
                  TEXT("Image has been successfully removed!"), 
                  TEXT("Success"), 
                  MB_OK);
   }
   return DICOM_SUCCESS;
}