JOB_INFO_1 struttura

Articolo
06/12/2023

La struttura JOB_INFO_1 specifica informazioni sul processo di stampa, ad esempio il valore dell'identificatore di processo, il nome della stampante per cui il processo viene eseguito ilpooling, il nome del computer che ha creato il processo di stampa, il nome dell'utente proprietario del processo di stampa e così via.

Sintassi

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

Members

Jobid

Identificatore di processo.

pPrinterName

Puntatore a una stringa con terminazione null che specifica il nome della stampante per cui viene eseguito ilpooling del processo.

pMachineName

Puntatore a una stringa con terminazione null che specifica il nome del computer che ha creato il processo di stampa.

pUserName

Puntatore a una stringa con terminazione null che specifica il nome dell'utente proprietario del processo di stampa.

pDocument

Puntatore a una stringa con terminazione null che specifica il nome del processo di stampa, ad esempio "MS-WORD: Review.doc").

pDatatype

Puntatore a una stringa con terminazione null che specifica il tipo di dati usato per registrare il processo di stampa.

pStatus

Puntatore a una stringa con terminazione null che specifica lo stato del processo di stampa. Questo membro deve essere controllato prima di Status e, se pStatus è NULL, lo stato viene definito dal contenuto del membro Status.

Status

Stato del processo. Il valore di questo membro può essere zero o una combinazione di uno o più dei valori seguenti. Un valore pari a zero indica che la coda di stampa è stata sospesa dopo il completamento della spooling del documento.

Valore	Significato
JOB_STATUS_BLOCKED_DEVQ	Il driver non può stampare il processo.
JOB_STATUS_COMPLETE	Windows XP e versioni successive: Il processo viene inviato alla stampante, ma il processo potrebbe non essere ancora stampato. Per ulteriori informazioni, vedere la sezione Osservazioni.
JOB_STATUS_DELETED	Il processo è stato eliminato.
JOB_STATUS_DELETING	Il processo viene eliminato.
JOB_STATUS_ERROR	Un errore è associato al processo.
JOB_STATUS_OFFLINE	La stampante è offline.
JOB_STATUS_PAPEROUT	La stampante è fuori carta.
JOB_STATUS_PAUSED	Il processo viene sospeso.
JOB_STATUS_PRINTED	Processo stampato.
JOB_STATUS_PRINTING	Il processo è la stampa.
JOB_STATUS_RESTART	Il processo è stato riavviato.
JOB_STATUS_RETAINED	Windows Vista e versioni successive: Il processo è stato mantenuto nella coda di stampa e non può essere eliminato. Ciò può essere causato dai seguenti problemi: 1) Il processo è stato mantenuto manualmente da una chiamata a SetJob e il spooler è in attesa del rilascio del processo. 2) Il processo non ha completato la stampa e deve terminare la stampa prima che possa essere eliminata automaticamente. Per altre informazioni sui comandi dei processi di stampa, vedere SetJob .
JOB_STATUS_SPOOLING	Il processo è spooling.
JOB_STATUS_USER_INTERVENTION	La stampante ha un errore che richiede all'utente di eseguire qualcosa.

Priorità

Priorità del processo. Questo membro può essere uno dei valori seguenti o nell'intervallo compreso tra 1 e 99 (MIN_PRIORITY tramite MAX_PRIORITY).

Valore	Significato
MIN_PRIORITY	Priorità minima.
MAX_PRIORITY	Priorità massima.
DEF_PRIORITY	Priorità predefinita.

Position

Posizione del processo nella coda di stampa.

TotalPages

Numero totale di pagine contenute nel documento. Questo valore può essere zero se il processo di stampa non contiene informazioni di delimitazione di pagina.

PagesPrinted

Numero di pagine stampate. Questo valore può essere zero se il processo di stampa non contiene informazioni di delimitazione di pagina.

Presentato

Struttura SYSTEMTIME che specifica l'ora di spooling del documento.

Questo valore di ora è in formato UTC (Universal Time Coordinate). È consigliabile convertirlo in un valore di ora locale prima di visualizzarlo. È possibile usare la funzione FileTimeToLocalFileTime per eseguire la conversione.

Commenti

I monitoraggi delle porte che non supportano TrueEndOfJob impostano il processo come JOB_STATUS_PRINTED subito dopo l'invio del processo alla stampante.

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)
Nomi Unicode e ANSI	_JOB_INFO_1W (Unicode) e _JOB_INFO_1A (ANSI)

Vedi anche

Stampa
Stampare strutture API Spooler
EnumJobs
GetJob
SetJob