Leadtools.Dicom Requires Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
UpdateFilmSession Method
See Also 
Leadtools.Dicom Namespace > DicomPrintScu Class : UpdateFilmSession Method



parameters
A DicomFilmSessionParameters object that specifies the Film Session parameters to be updated. The method will fail if this is set to a null reference (Nothing in Visual Basic).
parameters
A DicomFilmSessionParameters object that specifies the Film Session parameters to be updated. The method will fail if this is set to a null reference (Nothing in Visual Basic).
Requests the Print SCP to update the current Basic Film Session SOP Instance.

Syntax

Visual Basic (Declaration) 
Public Sub UpdateFilmSession( _
   ByVal parameters As DicomFilmSessionParameters _
) 
Visual Basic (Usage)Copy Code
Dim instance As DicomPrintScu
Dim parameters As DicomFilmSessionParameters
 
instance.UpdateFilmSession(parameters)
C# 
public void UpdateFilmSession( 
   DicomFilmSessionParameters parameters
)
C++/CLI 
public:
void UpdateFilmSession( 
   DicomFilmSessionParameters^ parameters
) 

Parameters

parameters
A DicomFilmSessionParameters object that specifies the Film Session parameters to be updated. The method will fail if this is set to a null reference (Nothing in Visual Basic).

Example

Remarks

Two of the exceptions that can be thrown by this method are:
Exception TypeCondition
DicomExceptionCode.PrintSCUFailureStatus The response of the Print SCP specifies a Failure status code.
DicomExceptionCode.PrintSCUClassNotSupported Neither the Basic Grayscale Print Management Meta SOP Class nor the Basic Color Print Management Meta SOP Class is supported on the Association.

There must be a Film Session currently created before using this method.

The method will not return until it receives the response of the Print SCP, or an error occurs. The method GetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. If the method UpdateFilmSession is successful, the Film Session was updated successfully, with either a Success or Warning status code in the response of the Print SCP.

The parameter parameters specifies the Film Session parameters to be updated. In the passed object, if a string property is a null reference (Nothing in Visual Basic), then the corresponding Attribute will not be included in the request to the Print SCP and hence will not be updated. Similarly, if a numeric property is negative, the corresponding Attribute will not be included in the request and hence will not be updated. The method will fail if parameters is set to a null reference or if all string properties are set to null references and all numeric properties are negative.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features