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

Platforms

Win32, x64

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;
}