Funzione GetJob

La funzione GetJob recupera informazioni su un processo di stampa specificato.

Sintassi

BOOL GetJob(
  _In_  HANDLE  hPrinter,
  _In_  DWORD   JobId,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pJob,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parametri

hPrinter [in]

Handle per la stampante per cui vengono recuperati i dati del processo di stampa. 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.

Livello [in]

Tipo di informazioni restituite nel buffer pJob . Se Level è 1, pJob riceve una struttura JOB_INFO_1 . Se Level è 2, pJob riceve una struttura JOB_INFO_2 .

pJob [out]

Puntatore a un buffer che riceve un JOB_INFO_1 o una struttura JOB_INFO_2 contenente informazioni sul processo. Il buffer deve essere sufficientemente grande da archiviare le stringhe a cui puntano i membri della struttura.

Per determinare le dimensioni del buffer necessarie, chiamare GetJob con cbBuf impostato su zero. GetJob ha esito negativo, GetLastError restituisce ERROR_INSUFFICIENT_BUFFER e il parametro pcbNeeded restituisce le dimensioni, in byte, del buffer necessario per contenere la matrice di strutture e i relativi dati.

cbBuf [in]

Dimensione, in byte, della matrice.

pcbNeeded [out]

Puntatore a un valore che specifica il numero di byte copiati se la funzione ha esito positivo o il numero di byte necessari se cbBuf è troppo piccolo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore 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.

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)
Libreria
Winspool.lib
DLL
Winspool.drv
Nomi Unicode e ANSI
GetJobW (Unicode) e GetJobA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

AddJob

JOB_INFO_1

JOB_INFO_2

ScheduleJob

SetJob