3 out of 4 rated this helpful - Rate this topic

ReadPrinter function

Applies to: desktop apps only

The ReadPrinter function retrieves data from the specified printer.

Syntax

Copy

BOOL ReadPrinter(
  __in   HANDLE hPrinter,
  __out  LPVOID pBuf,
  __in   DWORD cbBuf,
  __out  LPDWORD pNoBytesRead
);

Parameters

hPrinter [in]: A handle to the printer object for which to retrieve data. Use the OpenPrinter function to retrieve a printer object handle. Use the format: Printername, Job xxxx.
pBuf [out]: A pointer to a buffer that receives the printer data.
cbBuf [in]: The size, in bytes, of the buffer to which pBuf points.
pNoBytesRead [out]: A pointer to a variable that receives the number of bytes of data copied into the array to which pBuf points.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero.

Remarks

Note This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation—factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.

ReadPrinter returns an error if the device or the printer is not bidirectional.

Requirements