StatusFailureInvalidSopInstance Class

Summary

A class that represents an invalid SOP Instance status (0117H), and associated optional elements that can be included in the command set of a DIMSE service response.

Syntax

C++/CLI

public class StatusFailureInvalidSopInstance : StatusBase

public: 
   ref class StatusFailureInvalidSopInstance : StatusBase

Remarks

A DIMSE service response command set includes a required Status Element (0000,0900), and other optional Status Elements. A status element with a value of (0117H) represents an Invalid SOP Instance status, indicating the SOP Instance UID specified implied a violation of the UID construction rules.

The StatusFailureInvalidSopInstance class is used to read/write all invalid SOP Instance status command set elements.

To write optional command set elements associated with an invalid SOP Instance status:

Allocate an instance of the StatusFailureInvalidSopInstance class and initialize all members with appropriate values.
Subscribe to the DicomNet::OnBeforeSendCommandSet event, which is fired before sending any DIMSE service response.
Use the extension method Leadtools.Dicom.Common.Extensions.Set) to set the status elements in the command set.

The DIMSE services include:

C-STORE
C-GET
C-MOVE
C-FIND
C-ECHO
N-EVENT-REPORT
N-GET
N-SET
N-ACTION
N-CREATE
N-DELETE

Example

This example shows how to override the DicomNet::OnBeforeSendCommandSet event to write status and related optional status elements in a DICOM command set.

using Leadtools.Dicom; 
using Leadtools.Dicom.Common; 
using Leadtools.Dicom.Common.Extensions; 
using Leadtools; 
using Leadtools.Dicom.Common.Linq.BasicDirectory; 
using Leadtools.Dicom.Common.DataTypes; 
using Leadtools.Dicom.Common.DataTypes.Status; 
 
 
public class StatusFailureInvalidSopInstanceDicomNet : DicomNet 
{ 
   public StatusFailureInvalidSopInstanceDicomNet(string path, DicomNetSecurityMode mode) : base(path, mode) 
   { 
   } 
 
   public StatusFailureInvalidSopInstanceDicomNet(string path, DicomNetSecurityMode mode, bool reserved) : base(path, mode, reserved) 
   { 
   } 
 
   protected override void OnBeforeSendCommandSet(DicomDataSet cs) 
   { 
      // Return a Status of InvalidSopInstance and set the optional status elements 
      StatusFailureInvalidSopInstance s = new StatusFailureInvalidSopInstance(); 
 
      s.AffectedSOPInstanceUID = "1.2.840.114257.3.6.5.5.18900282"; 
      cs.Set(s); 
      base.OnBeforeSendCommandSet(cs); 
   } 
}