struttura PRINTER_NOTIFY_INFO_DATA

La struttura PRINTER_NOTIFY_INFO_DATA identifica un campo informativo di processo o stampante e fornisce i dati correnti per tale campo.

La funzione FindNextPrinterChangeNotification restituisce una struttura PRINTER_NOTIFY_INFO che contiene una matrice di strutture PRINTER_NOTIFY_INFO_DATA .

Sintassi

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

Members

Tipo

Indica il tipo di informazioni fornite. Questo membro può essere uno dei valori seguenti.

Valore Significato
JOB_NOTIFY_TYPE
0x01
Indica che il membro Field specifica una costante JOB_NOTIFY_FIELD_*.
PRINTER_NOTIFY_TYPE
0x00
Indica che il membro Field specifica una costante PRINTER_NOTIFY_FIELD_*.

Campo

Indica il campo modificato. Per un elenco dei valori possibili, vedere la sezione Osservazioni.

Reserved

Riservato.

Id

Indica l'identificatore del processo se il membro Type specifica JOB_NOTIFY_TYPE. Se il membro Type specifica PRINTER_NOTIFY_TYPE, questo membro non è definito.

NotifyData

Unione di informazioni sui dati in base ai membri Type e Field . Per una descrizione del tipo di dati associati a ogni campo, vedere la sezione Osservazioni.

adwData[2]

Matrice di due valori DWORD . Per i campi informativi che usano solo un singolo DWORD, i dati si trovano in adwData [0].

Dati

cbBuf

Indica le dimensioni, in byte, del buffer a cui punta pBuf.

pBuf

Puntatore a un buffer contenente i dati correnti del campo.

Commenti

Se il membro Type specifica PRINTER_NOTIFY_TYPE, il membro Field può essere uno dei valori seguenti.

Campo Tipo di dati Valore
PRINTER_NOTIFY_FIELD_SERVER_NAME Non supportato. 0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME pBuf è un puntatore a una stringa con terminazione Null contenente il nome della stampante. 0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME pBuf è un puntatore a una stringa con terminazione Null che identifica il punto di condivisione per la stampante. 0x02
PRINTER_NOTIFY_FIELD_PORT_NAME pBuf è un puntatore a una stringa con terminazione Null contenente il nome della porta in cui verranno stampati i processi di stampa. Se è selezionato "Pooling stampanti", si tratta di un elenco di porte delimitato da virgole. 0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME pBuf è un puntatore a una stringa con terminazione Null contenente il nome del driver della stampante. 0x04
PRINTER_NOTIFY_FIELD_COMMENT pBuf è un puntatore a una stringa con terminazione Null contenente la nuova stringa di commento, che in genere è una breve descrizione della stampante. 0x05
PRINTER_NOTIFY_FIELD_LOCATION pBuf è un puntatore a una stringa con terminazione Null contenente la nuova posizione fisica della stampante(ad esempio, "Bldg. 38, Room 1164"). 0x06
PRINTER_NOTIFY_FIELD_DEVMODE pBuf è un puntatore a una struttura DEVMODE che definisce i dati predefiniti della stampante, ad esempio l'orientamento della carta e la risoluzione. 0x07
PRINTER_NOTIFY_FIELD_SEPFILE pBuf è un puntatore a una stringa con terminazione Null che specifica il nome del file utilizzato per creare la pagina separatore. Questa pagina viene utilizzata per separare i processi di stampa inviati alla stampante. 0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR pBuf è un puntatore a una stringa con terminazione Null che specifica il nome del processore di stampa utilizzato dalla stampante. 0x09
PRINTER_NOTIFY_FIELD_PARAMETERS pBuf è un puntatore a una stringa con terminazione Null che specifica i parametri predefiniti del processore di stampa. 0x0A
PRINTER_NOTIFY_FIELD_DATATYPE pBuf è un puntatore a una stringa con terminazione Null che specifica il tipo di dati utilizzato per registrare il processo di stampa. 0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR pBuf è un puntatore a una struttura SECURITY_DESCRIPTOR per la stampante. Il puntatore può essere NULL se non è presente alcun descrittore di sicurezza. 0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES adwData [0] specifica gli attributi della stampante, che possono essere uno dei valori seguenti:
PRINTER_ATTRIBUTE_QUEUED
PRINTER_ATTRIBUTE_DIRECT
PRINTER_ATTRIBUTE_DEFAULT
PRINTER_ATTRIBUTE_SHARED
0x0d
PRINTER_NOTIFY_FIELD_PRIORITY adwData [0] specifica un valore di priorità usato dallo spooler per instradare i processi di stampa. 0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY adwData [0] specifica il valore di priorità predefinito assegnato a ogni processo di stampa. 0x0F
PRINTER_NOTIFY_FIELD_START_TIME adwData [0] specifica la prima volta in cui la stampante stampa un processo. Questo valore viene specificato in minuti trascorsi dalle 12:00 0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData [0] specifica l'ora più recente in cui la stampante stampa un processo. Questo valore viene specificato in minuti trascorsi dalle 12:00 A.M.) 0x11
PRINTER_NOTIFY_FIELD_STATUS adwData [0] specifica lo stato della stampante. Per un elenco di valori possibili, vedere la struttura PRINTER_INFO_2 . 0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING Non supportato. 0x13
PRINTER_NOTIFY_FIELD_CJOBS adwData [0] specifica il numero di processi di stampa che sono stati accodati per la stampante. 0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM adwData [0] specifica il numero medio di pagine al minuto stampato nella stampante. 0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES Non supportato. 0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED Non supportato. 0x17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES Non supportato. 0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED Non supportato. 0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID Questo valore viene impostato se il GUID dell'oggetto cambia. 0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME Questa opzione viene impostata se la connessione della stampante viene rinominata. 0x1B

Se il membro Type specifica JOB_NOTIFY_TYPE, il membro Field può essere uno dei valori seguenti.

Campo Tipo di dati Valore
JOB_NOTIFY_FIELD_PRINTER_NAME pBuf è un puntatore a una stringa con terminazione Null contenente il nome della stampante per cui viene eseguito ilpooling del processo. 0x00
JOB_NOTIFY_FIELD_MACHINE_NAME pBuf è un puntatore a una stringa con terminazione null che specifica il nome del computer che ha creato il processo di stampa. 0x01
JOB_NOTIFY_FIELD_PORT_NAME pBuf è un puntatore a una stringa con terminazione null che identifica le porte usate per trasmettere i dati alla stampante. Se una stampante è connessa a più porte, i nomi delle porte sono separati da virgole ( ad esempio "LPT1:,LPT2:,LPT3:"). 0x02
JOB_NOTIFY_FIELD_USER_NAME pBuf è un puntatore a una stringa con terminazione null che specifica il nome dell'utente che ha inviato il processo di stampa. 0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME pBuf è un 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. 0x04
JOB_NOTIFY_FIELD_DATATYPE pBuf è un puntatore a una stringa con terminazione null che specifica il tipo di dati utilizzato per registrare il processo di stampa. 0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR pBuf è un puntatore a una stringa con terminazione null che specifica il nome del processore di stampa da usare per stampare il processo. 0x06
JOB_NOTIFY_FIELD_PARAMETERS pBuf è un puntatore a una stringa con terminazione null che specifica i parametri del processore di stampa. 0x07
JOB_NOTIFY_FIELD_DRIVER_NAME pBuf è un 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. 0x08
JOB_NOTIFY_FIELD_DEVMODE pBuf è un puntatore a una struttura DEVMODE che contiene dati di inizializzazione e ambiente del dispositivo per il driver della stampante. 0x09
JOB_NOTIFY_FIELD_STATUS adwData [0] specifica lo stato del processo. Per un elenco di valori possibili, vedere la struttura JOB_INFO_2 . 0x0A
JOB_NOTIFY_FIELD_STATUS_STRING pBuf è un puntatore a una stringa con terminazione null che specifica lo stato del processo di stampa. 0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR Non supportato. 0x0C
JOB_NOTIFY_FIELD_DOCUMENT pBuf è un puntatore a una stringa con terminazione null che specifica il nome del processo di stampa, ad esempio "MS-WORD: Review.doc"). 0x0d
JOB_NOTIFY_FIELD_PRIORITY adwData [0] specifica la priorità del processo. 0x0E
JOB_NOTIFY_FIELD_POSITION adwData [0] specifica la posizione del processo nella coda di stampa. 0x0F
JOB_NOTIFY_FIELD_SUBMITTED pBuf è un puntatore a una struttura SYSTEMTIME che specifica l'ora di invio del processo. 0x10
JOB_NOTIFY_FIELD_START_TIME adwData [0] specifica la prima volta che è possibile stampare il processo. Questo valore viene specificato in minuti trascorsi dalle 12:00 A.M.) 0x11
JOB_NOTIFY_FIELD_UNTIL_TIME adwData [0] specifica l'ora più recente in cui è possibile stampare il processo. Questo valore viene specificato in minuti trascorsi dalle 12:00 A.M.) 0x12
JOB_NOTIFY_FIELD_TIME adwData [0] specifica il tempo totale, in secondi, trascorso dal momento che il processo ha iniziato la stampa. 0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES adwData [0] specifica le dimensioni, nelle pagine, del processo. 0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED adwData [0] specifica il numero di pagine stampate. 0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES adwData [0] specifica le dimensioni, in byte, del processo. 0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED adwData [0] specifica il numero di byte stampati in questo processo. Per questo campo, l'oggetto di notifica delle modifiche viene segnalato quando vengono inviati byte alla stampante. 0x17

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)

Vedi anche

Stampa

Stampare strutture API Spooler

DEVMODE

FindNextPrinterChangeNotification

JOB_INFO_2

PRINTER_INFO_2

PRINTER_NOTIFY_INFO

SECURITY_DESCRIPTOR

SYSTEMTIME