Create method (ILFilmSession Interface)

VB.NET example	C# example
Visual Basic example	Visual C++ 6.0 example

Syntax	short Create(VARIANT_BOOL bColorPrintManagement);
Overview	Refer to Print Management SCU.

Remarks

The Create method requests the Print SCP to create a Basic Film Session SOP Instance.

Once a Film Session is created, the Create method of the ILFilmBox interface can then be used to create one or more Film Boxes in the new Film Session. Notice that only one Film Session can be handled on the Association at any time.

The method will not return until it receives the response of the Print SCP or an error occurs. The status code specified in the response of the Print SCP is given by the LastOperationStatus property. When the return value of the method is 0, then this means that the Film Session was created successfully, with either a Success or Warning status code in the response of the Print SCP.

Having the Film Session created, its SOP Instance UID can be obtained from the SOPInstanceUID property. Also, the Update method, PrintSession method, and Delete method can be used to update, print, and delete the Film Session, respectively.

Before calling the method, the various properties can be used to set the parameters of the Film Session to be created. Only those parameters specified by the IncludedParameters property will be included. If a parameter is not specified, the corresponding Attribute will not be included in the request to the Print SCP.

All the rest of the basic Print Management methods, defined by the ILFilmSession interface and by the other interfaces, will adopt the Meta SOP Class of the created Basic Film Session SOP Instance.

Elements:	IncludedParameters property, SOPInstanceUID property, Update method, PrintSession method, Delete method, Create method (ILFilmBox interface), LastOperationStatus property
Topics:	DICOM Print Management SCU: Basic Print Management