Adobe ColdFusion 8

GetPrinterInfo

Description

Determines which print attributes are supported by a selected printer.

Returns

A structure that contains the attributes supported by the printer. If the printer is an empty string, the structure contains attributes supported by the default printer, if one exists.

Category

System functions

Function syntax

GetPrinterInfo("printer")

See also

cfpdf, cfprint

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

printer

The name of a printer. An example in Windows is "\\s1001prn02\NTN-2W-HP_BW02". The default is the default printer for the account where the ColdFusion server is running. Printer names are case-sensitive and must be entered exactly as they appear in the System Information page of the ColdFusion Administrator.

If you specify an empty string, for example GetPrinterInfo(""), ColdFusion generates and error. Use the following code to retrieve information on the default printer: GetPrinterInfo().

Usage

Use this function in conjunction with the cfprint tag when processing large print jobs. Not all printers support the complete list of print attributes allowed by the cfprint tag. If the selected printer does not support a print attribute, the printer ignores the attribute.

For more information, see attributeStruct.

Example

<!--- The following code returns information on the default printer. --->
<cfdump var="#GetPrinterInfo()#">

<!--- The following code returns information on the specified printer. --->
<cfdump var="#GetPrinterInfo('\\S1001prn02\NTN-2W-SHARP01')#">