ENUMPAPERBINS

Syntax

short Escape(hDC, ENUMPAPERBINS, sizeof(int),lpNumBins,lpOutData)

This escape retrieves attribute information about a specified number of paper bins. The GETSETPAPERBINS escape retrieves the number of bins available on a printer. This escape is provided only for backward compatibility. An application should call the ExtDeviceMode function instead.

Parameter Type/Description  

hDC HDC Identifies the device context.  
lpNumBins LPINT Points to an integer that specifies the number of bins for which information is to be retrieved.  
lpOutData LPSTR Points to a data structure to which information about the paper bins is copied. The size of the structure depends on the number of bins for which information was requested. See the following “Comments” section for a description of this data structure.  

Return Value

The return value specifies the outcome of the escape. It is 1 if the escape is successful; it is zero if the escape is not successful or not implemented.

Comments

The data structure to which the lpOutData parameter points consists of two arrays. The first is an array of short integers containing the paper-bin identifier numbers in the following format:

short BinList[cBinMax]

The number of integers in the array (cBinMax) is equal to the value pointed to by the lpNumBins parameter.

The second array in the data structure to which lpOutData points is an array of characters in the following format:

char PaperNames[cBinMax][cchBinName]

The cBinMax value is equal to the value pointed to by the lpNumBins parameter; the cchBinName value is the length of each string (currently 24).