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	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Spoolss.dll

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

EPrintXPSJobOperation

EPrintXPSJobProgress