struttura PRINT_OTHER_INFO (lmalert.h)

Articolo
03/13/2024

La struttura PRINT_OTHER_INFO contiene informazioni su un processo di stampa. Le funzioni NetAlertRaise e NetAlertRaiseEx usano la struttura PRINT_OTHER_INFO per specificare le informazioni al termine della stampa di un processo o quando una stampante richiede l'intervento.

Sintassi

typedef struct _PRINT_OTHER_INFO {
  DWORD alrtpr_jobid;
  DWORD alrtpr_status;
  DWORD alrtpr_submitted;
  DWORD alrtpr_size;
} PRINT_OTHER_INFO, *PPRINT_OTHER_INFO, *LPPRINT_OTHER_INFO;

Members

alrtpr_jobid

Tipo: DWORD

Numero di identificazione del processo di stampa.

alrtpr_status

Tipo: DWORD

Maschera di bit che descrive lo stato del processo di stampa.

È possibile ottenere lo stato complessivo del processo controllando PRJOB_QSTATUS (bit 0 e 1).

I valori possibili per lo stato del processo di stampa sono elencati nel file di intestazione Lmalert.h .

Valore	Significato
PRJOB_QS_QUEUED 0	Il processo di stampa si trova nella coda in attesa di essere pianificato.
PRJOB_QS_PAUSED 1	Il processo di stampa si trova nella coda, ma è stato sospeso. Quando un processo viene sospeso, non può essere pianificato.
PRJOB_QS_SPOOLING 2	Il processo di stampa è in corso di spooling.
PRJOB_QS_PRINTING 3	Il processo è attualmente in corso di stampa.

Se il processo di stampa è nello stato PRJOB_QS_PRINTING, è possibile controllare i bit da 2 a 8 per lo stato del dispositivo (PRJOB_DEVSTATUS). Anche il bit 15 è significativo.

I valori possibili per lo stato del dispositivo sono elencati nel file di intestazione Lmalert.h .

Valore	Significato
PRJOB_COMPLETE 0x4	Il processo ha completato la stampa.
PRJOB_INTERV 0x8	La stampante di destinazione richiede l'intervento di un operatore.
PRJOB_ERROR 0x10	Si è verificato un errore nella stampante di destinazione.
PRJOB_DESTOFFLINE 0x20	La stampante di destinazione è offline.
PRJOB_DESTPAUSED 0x40	La stampante di destinazione è sospesa.
PRJOB_NOTIFY 0x80	Deve essere generato un avviso di stampa.
PRJOB_DESTNOPAPER 0x100	La stampante di destinazione è fuori carta.
PRJOB_DELETED 0x8000	Il processo di stampa viene eliminato.

alrtpr_submitted

Tipo: DWORD

Ora in cui è stato inviato il processo di stampa. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT.

alrtpr_size

Tipo: DWORD

Dimensione, in byte, del processo di stampa.

Commenti

I dati a lunghezza variabile aggiuntivi seguono la struttura PRINT_OTHER_INFO nel buffer dei messaggi di avviso. Le informazioni sono sotto forma di stringhe di caratteri con terminazione Null contigue, come indicato di seguito.

string	Significato
nomecomputer	Computer che ha inviato il processo di stampa.
username	Utente che ha inviato il processo di stampa.
Queuename	Coda di stampa a cui è stato inviato il processo.
destination	Destinazione della stampante (dispositivo) a cui è stato instradato il processo di stampa.
status	Stato del processo di stampa.

L'applicazione chiamante deve allocare e liberare la memoria per tutte le strutture e i dati a lunghezza variabile in un buffer dei messaggi di avviso.

Per un esempio di codice che illustra come generare un avviso di stampa, vedere NetAlertRaiseEx .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	lmalert.h (include Lm.h)