StatusFailureRefusedNotAuthorized Class

Summary

A class that represents a Refused: Not authorized status (0124H), and associated optional elements that can be included in the command set of a DIMSE service response.

Syntax

C++

public class StatusFailureRefusedNotAuthorized : StatusBase

Public Class StatusFailureRefusedNotAuthorized 
   Inherits StatusBase

public: 
   ref class StatusFailureRefusedNotAuthorized : 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 (0124H) represents a Refused: Not authorized status, indicating the peer DIMSE Service User was not authorized to C-STORE, C-FIND, or C-MOVE the composite SOP Instance.

The StatusFailureRefusedNotAuthorized class is used to read/write Refused: Not authorized status command set elements.

To write optional command set elements associated with a Refused: Not authorized status:

Allocate an instance of the StatusFailureRefusedNotAuthorized 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 StatusFailureRefusedNotAuthorizedDicomNet : DicomNet 
{ 
   public StatusFailureRefusedNotAuthorizedDicomNet(string path, DicomNetSecurityMode mode) : base(path, mode) 
   { 
   } 
 
   public StatusFailureRefusedNotAuthorizedDicomNet(string path, DicomNetSecurityMode mode, bool reserved) : base(path, mode, reserved) 
   { 
   } 
 
   protected override void OnBeforeSendCommandSet(DicomDataSet cs) 
   { 
      // Return a Status of NoSuchSopInstance and set the optional status elements 
      StatusFailureRefusedNotAuthorized s = new StatusFailureRefusedNotAuthorized(); 
 
      s.ErrorComment = "Authorization Violation. Current user does not have required permissions"; 
 
      cs.Set(s); 
      base.OnBeforeSendCommandSet(cs); 
   } 
}