Funzione ReadPrinter

La funzione ReadPrinter recupera i dati dalla stampante specificata.

Sintassi

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

Parametri

hPrinter [in]

Handle per l'oggetto stampante per cui recuperare i dati. Usare la funzione OpenPrinter per recuperare un handle dell'oggetto stampante. Usare il formato: Nome stampante, Job xxxx.

pBuf [out]

Puntatore a un buffer che riceve i dati della stampante.

cbBuf [in]

Dimensioni, in byte, del buffer a cui pBuf punta.

pNoBytesRead [out]

Puntatore a una variabile che riceve il numero di byte di dati copiati nella matrice in cui pBuf punta.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.

ReadPrinter restituisce un errore se il dispositivo o la stampante non è bidirezionale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Spoolss.dll

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

OpenPrinter