Compartir a través de


Función ReadPrinter

La función ReadPrinter recupera datos de la impresora especificada.

Sintaxis

BOOL ReadPrinter(
  _In_  HANDLE  hPrinter,
  _Out_ LPVOID  pBuf,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pNoBytesRead
);

Parámetros

hPrinter [in]

Identificador del objeto de impresora para el que se van a recuperar datos. Use la función OpenPrinter para recuperar un identificador de objeto de impresora. Use el formato: Printername, Job xxxx.

pBuf [out]

Puntero a un búfer que recibe los datos de la impresora.

cbBuf [in]

Tamaño, en bytes, del búfer al que apunta pBuf .

pNoBytesRead [out]

Puntero a una variable que recibe el número de bytes de datos copiados en la matriz a la que apunta pBuf .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Nota

Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

ReadPrinter devuelve un error si el dispositivo o la impresora no son bidireccionales.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Winspool.h (incluye Windows.h)
Biblioteca
Winspool.lib
Archivo DLL
Spoolss.dll

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

OpenPrinter