Create method (ILPullPrintRequest Interface)

Remarks

The Create method requests the Print SCP to create a Pull Print Request SOP Instance.

Only one Pull Print Request SOP Instance can be supported 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 Pull Print Request SOP Instance was created successfully, with either a Success or Warning status code in the response of the Print SCP.

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

Before calling the method, the AddStoredPrintItem method must be used to specify at least one Stored Print Storage SOP Instance to be referenced; otherwise, the Create method will return an error.

Also, before calling the method, the various properties can be used to set the parameters of the Pull Print Request SOP Instance 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.

See Also