Remote Printing SDK for Thinfinity - C#

Objective
The Remote Printing SDK allows you to programmatically send commands and documents to the end-user’s printer. Currently, raw printers are supported.
The following table shows the methods of the Remote Printer SDK.
Components
​
​
Remote Printer SDK Library
Thinfinity.RemotePrinter.dll
This module presents an COM API to be consumed by a Windows application running under Thinfinity VirtualUI or Thinfinity Remote Desktop.
Thinfinity Local Agent and Local Printer Plugin
Executable and library needed to work as a nexus between the web browser and local or network resources, otherwise inaccessible due to browser’s security restrictions.
Thinfinity Virtual Channels
A proprietary Virtual Channel System used to communicate the Remote Printer SDK with the Local Printer plugin.
Basic Scheme
The Remote Printer SDK tasks:
1.Retrieve the printer list.
2.Prepare the connection for printing.
3.Send data to the printer
4.Inform the end of the printing process.
5.In case of any error must be Cancel the printing or if the user wants.
6.In case of any error, can get it more details using LastError method
API
The following table shows the methods of the Remote Printer SDK.
Methods
 
 
GetPrinters
bool GetPrinters(string Delimiter, out string Printers);

Retrieve all printer names detected on the end-user's side. Returns a string delimited by the Delimiter parameter.

Returns: True if is successful and False in case of error.
Parameters
Delimiter
Printers (out)
String - Character or string used as delimiter of the printer names on Printers param.
String - Out parameter filled with the printer names delimited by Delimiter param
 
 
LastError
void LastError(out int ErrorCode, out string ErrorMessage);
​
Retrieves the last ErrorCode and ErrorMessage. Can be used when a call to any method returns False.

Returns: nothing
Parameters
ErrorCode (out)
ErrorMessage (out)
Int - Out last error code. If ErrorCode is 0, there is not error
String - Out last error message.
 
 
BeginDoc
bool BeginDoc(int PrintType, string PrinterName, string DocName, int Encoding, out string DocID);
​
It makes the connection with the printer and initializes the print job. Creates an unique Document Id to identify a print job in subsequent calls.

Returns: True if the communication and actions on the selected printer was sent successful.
Parameters
PrintType
PrinterName
DocName
Encoding
DocID (out)
Int - Determines the type of printing. Now support PRINT_TYPE_RAW = 1
String - The name that identifies the printer.
String - Name of the printer job to be created on the print spooler.
Int - Identifies the format of the document to print. 
PRINT_ENCODE_ANSI = 0 
PRINT_ENCODE_UTF8 = 1
String - This out parameter is filled with a unique document id to be used in subsequent calls.
 
 
Print
bool Print(string DocID, string Data);
​
Sends data to the printer using the document identifier obtained using BeginDoc..
This method can be called as many times as needed to send commands or data until the entire print job is completed. 

Returns: True if nothing went wrong.
Parameters
DocID
Data
String - The document identifier obtained by BeginDoc
String - Data to be sent to the Printer.
 
 
EndDoc
bool EndDoc(string DocID);
​
Ends the print job. This completes the print process and sends the print job to the spooler.

Returns: True if the work was sent to the printer spooler.
Parameters
DocID
String - The document identifier obtained by BeginDoc
 
 
Abort
bool Abort(string DocID);
​
Cancels the printer job. 
This method must be called in case of the methods Print or EndDoc return False.
Parameters
DocID
String - The document identifier obtained by BeginDoc
 
 
PrintFile
bool PrintFile(int PrintType, string FileName, string PrinterName);
​
Sends the file to the print spooler of the remote printer. In case of PrinterName is Empty the default remote printer is used.

Parameters
PrintType
FileName
PrinterName
Int - Determines the type of printing.
Now support:
PRINT_TYPE_XPS = 3
PRINT_TYPE_PDF = 4
PRINT_TYPE_DIRECT = 5
String - Full FileName of the file to Print.
String - The name that identifies the printer.

Printing Preview and Printing

Remote Printing SDK for Thinfinity - Delphi

Last modified 1yr ago


Remote Printer SDK Library Thinfinity.RemotePrinter.dll	This module presents an COM API to be consumed by a Windows application running under Thinfinity VirtualUI or Thinfinity Remote Desktop.
Thinfinity Local Agent and Local Printer Plugin	Executable and library needed to work as a nexus between the web browser and local or network resources, otherwise inaccessible due to browser’s security restrictions.
Thinfinity Virtual Channels	A proprietary Virtual Channel System used to communicate the Remote Printer SDK with the Local Printer plugin.


GetPrinters	bool GetPrinters(string Delimiter, out string Printers); Retrieve all printer names detected on the end-user's side. Returns a string delimited by the Delimiter parameter. Returns: True if is successful and False in case of error.


LastError	void LastError(out int ErrorCode, out string ErrorMessage); Retrieves the last ErrorCode and ErrorMessage. Can be used when a call to any method returns False. Returns: nothing


BeginDoc	bool BeginDoc(int PrintType, string PrinterName, string DocName, int Encoding, out string DocID); It makes the connection with the printer and initializes the print job. Creates an unique Document Id to identify a print job in subsequent calls. Returns: True if the communication and actions on the selected printer was sent successful.


Print	bool Print(string DocID, string Data); Sends data to the printer using the document identifier obtained using BeginDoc.. This method can be called as many times as needed to send commands or data until the entire print job is completed. Returns: True if nothing went wrong.


EndDoc	bool EndDoc(string DocID); Ends the print job. This completes the print process and sends the print job to the spooler. Returns: True if the work was sent to the printer spooler.


Abort	bool Abort(string DocID); Cancels the printer job. This method must be called in case of the methods Print or EndDoc return False.


PrintFile	bool PrintFile(int PrintType, string FileName, string PrinterName); Sends the file to the print spooler of the remote printer. In case of PrinterName is Empty the default remote printer is used.