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