Funzione ReportJobProcessingProgress
Segnala al servizio Spooler di stampa se un processo di stampa XPS si trova nello spooling o nella fase di rendering e quale parte dell'elaborazione è attualmente in corso.
Sintassi
HRESULT ReportJobProcessingProgress(
_In_ HANDLE printerHandle,
_In_ ULONG jobId,
EPrintXPSJobOperation jobOperation,
EPrintXPSJobProgress jobProgress
);
Parametri
-
printerHandle [in]
-
Handle della stampante per il quale la funzione deve recuperare informazioni. Utilizzare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.
-
jobId [in]
-
Identifica il processo di stampa per il quale recuperare i dati. Usare la funzione AddJob o la funzione StartDoc per ottenere un identificatore del processo di stampa.
-
jobOperation
-
Specifica se il processo si trova nella fase di spooling o nella fase di rendering.
-
jobProgress
-
Specifica quale parte dell'elaborazione è attualmente in corso. Questo valore fa riferimento agli eventi nella fase di spooling o rendering a seconda del valore di jobOperation.
Valore restituito
Se l'operazione ha esito positivo, il valore restituito viene S_OK; in caso contrario , HRESULT conterrà un codice di errore.
Per altre informazioni sui codici di errore COM, vedere Gestione degli errori.
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.
Nota
ReportJobProcessingProgress segnala solo lo stato di avanzamento del processo di stampa XPS se il processo di stampa si trova nella fase di spooling o rendering. ReportJobProcessingProgress avrà esito negativo se viene chiamato quando il processo di stampa XPS non si trova nella fase di spooling o rendering.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|