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 |
|
| Libreria |
|
| DLL |
|