Funzione FlushPrinter
La funzione FlushPrinter invia un buffer alla stampante per cancellarlo da uno stato temporaneo.
Sintassi
BOOL FlushPrinter(
_In_ HANDLE hPrinter,
_In_ LPVOID pBuf,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcWritten,
_In_ DWORD cSleep
);
Parametri
-
hPrinter [in]
-
Handle per l'oggetto stampante. Deve essere lo stesso handle usato, in una precedente chiamata WritePrinter , dal driver della stampante.
-
pBuf [in]
-
Puntatore a una matrice di byte che contiene i dati da scrivere nella stampante.
-
cbBuf [in]
-
Dimensione, in byte, della matrice a cui punta pBuf.
-
pcWritten [out]
-
Puntatore a un valore che riceve il numero di byte di dati scritti nella stampante.
-
cSleep [in]
-
Tempo, in millisecondi, per il quale la riga di I/O sulla porta della stampante deve essere mantenuta inattiva.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è 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à di restituzione di questa funzione 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. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.
FlushPrinter deve essere chiamato solo se WritePrinter non è riuscito, lasciando la stampante in uno stato temporaneo. Ad esempio, la stampante potrebbe entrare in uno stato temporaneo quando il processo viene interrotto e il driver della stampante ha inviato parzialmente alcuni dati non elaborati alla stampante.
FlushPrinter può anche specificare un periodo di inattività durante il quale lo spooler di stampa non pianifica alcun processo sulla porta della stampante corrispondente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|