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_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 |
|