struttura JOB_INFO_2

Articolo
06/12/2023

La struttura JOB_INFO_2 descrive un set completo di valori associati a un processo.

Sintassi

typedef struct _JOB_INFO_2 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
} JOB_INFO_2, *PJOB_INFO_2;

Members

Jobid

Valore dell'identificatore del 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").

pNotifyName

Puntatore a una stringa con terminazione null che specifica il nome dell'utente che deve ricevere una notifica quando il processo è stato stampato o quando si verifica un errore durante la stampa del processo.

pDatatype

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

pPrintProcessor

Puntatore a una stringa con terminazione null che specifica il nome del processore di stampa che deve essere usato per stampare il processo.

pParameters

Puntatore a una stringa con terminazione null che specifica i parametri del processore di stampa.

pDriverName

Puntatore a una stringa con terminazione null che specifica il nome del driver della stampante che deve essere usato per elaborare il processo di stampa.

pDevMode

Puntatore a una struttura DEVMODE che contiene i dati di inizializzazione del dispositivo e dell'ambiente per il driver della stampante.

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.

pSecurityDescriptor

Il valore di questo membro è NULL. Il recupero e l'impostazione dei descrittori di sicurezza dei documenti non sono supportati in questa versione.

Status

Stato del processo. Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
JOB_STATUS_BLOCKED_DEVQ	Il driver non può stampare il processo.
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_SPOOLING	Il processo è spooling.
JOB_STATUS_USER_INTERVENTION	La stampante ha un errore che richiede all'utente di eseguire qualcosa.

In Windows XP e versioni successive di Windows è anche possibile usare i valori seguenti:

Valore	Significato
JOB_STATUS_COMPLETE	Il processo viene inviato alla stampante, ma potrebbe non essere ancora stampato. Per ulteriori informazioni, vedere la sezione Osservazioni.
JOB_STATUS_RETAINED	Il processo è stato mantenuto nella coda di stampa seguente.

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.

StartTime

La prima volta che è possibile stampare il processo.

UntilTime

Ultima volta che è possibile stampare il processo.

TotalPages

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

Dimensione

Dimensioni, in byte, del processo.

Presentato

Struttura SYSTEMTIME che specifica l'ora di invio del processo.

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.

Time

Tempo totale, in millisecondi, trascorso dal processo di stampa.

PagesPrinted

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

Commenti

I monitoraggi delle porte che non supportano TrueEndOfJob imposteranno 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_2W (Unicode) e _JOB_INFO_2A (ANSI)

Vedi anche

Stampa
Stampare le strutture dell'API Spooler
DEVMODE
EnumJobs
GetJob
SetJob